Instalação

Cinco minutos. Sem arquivo SQL, sem configuração de framework — apenas uma permissão e uma reinicialização.

Antes de começar

Você precisa	Por quê
ESX, QBCore ou QBox	Itens utilizáveis, empregos, notificações e status vêm do framework
oxmysql	As configurações dos itens são salvas em uma tabela chamada `mic_itemcreator`
Um inventário que execute itens utilizáveis do framework	É assim que o uso do item chega até este resource
ox_lib, ox_target / qb-target, screenshot-basic	Opcionais; veja Personalização

1. Coloque a pasta no lugar

Baixe mic_itemcreator dos seus assets concedidos na Cfx.re e coloque a pasta nos seus resources, por exemplo resources/[mic]/mic_itemcreator.

2. Inicie depois das dependências

No server.cfg, ensure mic_itemcreator deve ficar abaixo do oxmysql, do seu framework (es_extended, qb-core ou qbx_core) e do seu inventário.

O framework é encontrado procurando por um es_extended ou qb-core já iniciado, portanto a ordem importa: se iniciar cedo demais, ele não encontrará nenhum dos dois. O QBox é encontrado através da sua compatibilidade com QBCore — qbx_core fornece qb-core — então não há nada para configurar.

3. O banco de dados — nada a fazer

Na primeira inicialização, o resource cria a tabela mic_itemcreator (uma linha por item configurado) e adiciona qualquer coluna que uma versão mais antiga não tivesse. Não há arquivo SQL para importar.

Funcionou quando a tabela mic_itemcreator estiver no seu banco de dados após a primeira inicialização.

4. Itens

O Item Creator não adiciona itens ao seu inventário — ele dá uma função aos itens que você já tem. Cada item que você configurar deve existir no seu inventário primeiro.

Nenhuma definição de item ou imagem vem incluída. Para novos itens, a Registry Tool do menu escreve a definição para você: escolha OX, QBCORE ou ESX SQL, preencha os campos e copie o resultado para ox_inventory/data/items.lua, qb-core/shared/items.lua ou para a sua tabela items do ESX. As imagens vão na pasta de imagens do seu próprio inventário, com o nome do item.

O menu é protegido pela permissão ACE mic_itemcreator.open. Conceda-a no server.cfg com uma linha add_ace — para uma pessoa, por exemplo add_ace identifier.discord:YOUR_DISCORD_ID mic_itemcreator.open allow, ou para um grupo, por exemplo add_ace group.admin mic_itemcreator.open allow.

A permissão é verificada quando você entra no servidor. Concedeu enquanto já estava conectado? Reconecte.

Funcionou quando /itemcreator abrir o menu no painel inicial. Sem a permissão, você recebe a notificação de “sem permissão”.

6. Primeiro teste

/itemcreator → Usable Items, e escolha um item que exista no seu inventário, por exemplo water.
Adicione uma funcionalidade Notification com uma mensagem e uma funcionalidade Food/Thirst com um pouco de sede.
Abra as configurações do item, ative Remove on Use com 1 e salve.
Dê o item a si mesmo (o menu tem um botão para isso, um de cada vez) e use-o pelo seu inventário.

Funcionou quando a notificação aparecer, sua sede aumentar e uma unidade do item for consumida.

Antes de abrir sua cidade

Apenas as pessoas certas têm mic_itemcreator.open. Ele pode fazer qualquer item executar qualquer coisa, incluindo gerar carros, executar comandos e conceder superpoderes.
Cada item configurado existe no seu inventário, com o mesmo nome.
Verifique se Config.ImageInventoryPath aponta para a pasta de imagens do seu inventário, caso contrário o menu não mostrará imagens.
Avise seus jogadores sobre a tecla de cancelar — X por padrão — que interrompe animações, cenários, estilos de caminhada, velocidade, superpoderes e props iniciados por um item.