Instalação

Nota

💬 Precisa de ajuda? Suporte, atualizações e changelogs estão no Discord da Mic Scripts. Abra um ticket com o seu ID de transação do Tebex e o erro do console.

Cinco minutos. Sem SQL, sem arquivo de itens para importar: o que você precisa é do lb-phone, uma linha em config.lua e drogas no seu inventário que o aplicativo possa vender.

---

Antes de começar

Você precisa	Por quê
lb-phone	O aplicativo roda nele, e todas as notificações passam por ele
ESX, QBCore ou QBox	Inventário, dinheiro, empregos e a identidade do jogador
Itens de drogas no inventário	O app vende o que os jogadores carregam; ele não cria itens

---

1. Coloque a pasta no lugar

Coloque mic_drugdealer nos seus resources, por exemplo resources/[mic]/mic_drugdealer.

Cuidado

Mantenha a pasta com o nome mic_drugdealer. As telas do aplicativo fazem chamadas para o resource usando exatamente esse nome; se renomeado, a lista de drogas ficará vazia.

---

2. Inicie após o lb-phone e seu framework

No server.cfg, adicione ensure mic_drugdealer em uma linha abaixo do seu framework e abaixo de lb-phone.

O aplicativo aguarda o lb-phone e se adiciona novamente sempre que o lb-phone reinicia, então a ordem é flexível, mas o framework deve iniciar primeiro: o lado do servidor o requisita no exato momento em que é iniciado.

---

3. O banco de dados — nada a fazer

Os níveis e contagens de vendas são salvos em player_data.json na pasta do resource. O resource cria esse arquivo caso ele não exista. Seu servidor deve ter permissão de escrita nessa pasta.

---

4. Defina o seu framework

Este não é detectado automaticamente. Abra config.lua e defina Config.Framework:

Seu framework	Valor
ESX	"ESX"
QBCore	"QB"
QBox	"QB"

Letras maiúsculas importam. Se o resource do seu framework tiver um nome personalizado, altere Config.esxResourceName ou Config.qbResourceName para corresponder; caso contrário, não mexa neles.

No QBox, use "QB" e mantenha Config.qbResourceName como "qb-core": o QBox executa resources QBCore através de sua camada de compatibilidade, e qbx_core fornece qb-core.

---

5. Os itens

O resource não traz definições de itens: ele vende itens que o seu inventário já conhece. A configuração padrão espera estes nomes:

Item	Vendido como	Zonas	Nível
maria	Weed	Grove	1
coca	Coke	Pier, Paleto	3
lsd	LSD	Grove, Pier, Vinewood	2
meta	Meth	Sandy, Paleto	4
mush	Mushroom	Grove, Sandy	2
opium	Opium	Paleto	1
crack	Crack	Grove, Sandy	3
heroin	Heroin	Sandy, Paleto	5
xtc	Ecstasy	Pier, Vinewood	2
oxy	Oxycontin	Vinewood, Sandy	3
lean	Lean	Grove, Pier	1
hash	Hash	Grove, Vinewood	2

Suas drogas provavelmente têm outros nomes. Altere o campo item de cada entrada em Config.drugs para corresponder ao seu inventário, em vez de criar novos itens — veja Personalização.

Os itens de dinheiro também importam:

• ESX com Config.MoneyAsItem = true paga black_money (ou Config.MoneyItem quando o dinheiro sujo está desativado) como um item — ideal para ox_inventory.
• QBCore paga dinheiro sujo como um item chamado blackmoney. Certifique-se de que esse item exista, ou desative Config.BlackMoney.

As imagens em ui/img/ são os ícones de drogas do próprio aplicativo. São arquivos PNG comuns, então você pode copiá-los para a pasta de imagens do seu inventário se quiser o mesmo visual lá.

---

6. Primeiro teste

1. Coloque Config.MinimumPolice = 0 para o teste — o valor padrão é 1, e ninguém compra sem policiais online.
2. Entre com um emprego que não esteja em Config.BlockedAppJobs (polícia, xerife, ambulância e mecânico estão).
3. Abra o lb-phone, procure Drug Dealer na App Store e instale-o.
4. Dê a si mesmo algumas unidades de maria, abra o aplicativo, toque em DRUGS, depois em Weed e em SELL.

Funcionou quando uma rota vermelha aparecer no mapa com uma contagem regressiva no aplicativo. Dirija até lá, caminhe até o marcador da porta e pressione E: o jogador bate na porta, um comprador sai e o celular informa o que você vendeu e por quanto. PROFILE agora mostra uma venda.

---

Antes de abrir sua cidade

• Volte Config.MinimumPolice para o valor que sua cidade deseja.
• Limpe o progresso de teste. player_data.json vem com entradas de exemplo e guarda as suas do teste. Delete o arquivo; o resource criará um vazio na próxima inicialização.
• Ajuste cada nome de item em Config.drugs para corresponder ao seu inventário. Uma droga que ninguém pode carregar vira um botão que apenas diz “Você não tem o suficiente”.
• Verifique o item de dinheiro para o seu framework, conforme explicado acima.
• Verifique se Config.BlockedAppJobs e Config.PoliceJobs usam os nomes de empregos do seu servidor.