Installazione

Cinque minuti. Nessun file SQL, nessun file di oggetti da importare: tutto ciò che ti serve è lb-phone, una riga in config.lua e le droghe nel tuo inventario che l’app può vendere.

Prima di iniziare

Ti serve	Perché
lb-phone	L’app gira lì dentro e ogni notifica passa attraverso di esso
ESX, QBCore o QBox	Inventario, denaro, lavori e identità del giocatore
Oggetti droga nel tuo inventario	L’app vende ciò che i giocatori portano con sé; non crea oggetti

1. Posiziona la cartella

Inserisci mic_drugdealer nelle tue risorse, ad esempio resources/[mic]/mic_drugdealer.

2. Avviala dopo lb-phone e il tuo framework

Nel server.cfg, aggiungi ensure mic_drugdealer su una riga sotto il tuo framework e sotto lb-phone.

L’app attende lb-phone e si riaggiunge automaticamente ogni volta che lb-phone viene riavviato, quindi l’ordine è flessibile, ma il framework deve essere già attivo: il lato server lo richiede nel momento esatto in cui parte.

3. Il database — nulla da fare

I livelli e il conteggio delle vendite vengono salvati in player_data.json nella cartella della risorsa. La risorsa lo crea se manca. Il tuo server deve avere i permessi di scrittura su quella cartella.

4. Imposta il tuo framework

Qui non c’è rilevamento automatico. Apri config.lua e imposta Config.Framework:

Il tuo framework	Valore
ESX	`"ESX"`
QBCore	`"QB"`
QBox	`"QB"`

Le maiuscole contano. Se la risorsa del tuo framework ha un nome personalizzato, modifica Config.esxResourceName o Config.qbResourceName per farlo corrispondere; altrimenti lasciali così come sono.

Su QBox, usa "QB" e lascia Config.qbResourceName su "qb-core": QBox esegue le risorse QBCore tramite il suo livello di compatibilità e qbx_core fornisce qb-core.

5. Gli oggetti

La risorsa non include definizioni di oggetti: vende gli oggetti che il tuo inventario conosce già. La configurazione predefinita si aspetta questi nomi:

Oggetto	Venduto come	Zone	Livello
`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

Le tue droghe probabilmente si chiamano in un altro modo. Modifica il campo item di ciascuna voce in Config.drugs per farlo corrispondere al tuo inventario, invece di creare nuovi oggetti — vedi Personalizzazione.

Anche gli oggetti per il denaro sono importanti:

ESX con Config.MoneyAsItem = true paga black_money (o Config.MoneyItem quando il denaro sporco è disattivato) come oggetto — perfetto per ox_inventory.
QBCore paga il denaro sporco come un oggetto chiamato blackmoney. Assicurati che quell’oggetto esista, oppure disattiva Config.BlackMoney.

Le immagini in ui/img/ sono le icone delle droghe proprie dell’app. Sono normali file PNG, quindi puoi copiarle nella cartella immagini del tuo inventario se desideri avere lo stesso aspetto anche lì.

6. Primo test

Imposta Config.MinimumPolice = 0 per il test — il valore predefinito è 1, e nessuno compra se non c’è polizia online.
Entra con un lavoro che non sia in Config.BlockedAppJobs (polizia, sceriffo, ambulanza e meccanico lo sono).
Apri lb-phone, cerca Drug Dealer nell’App Store e installala.
Datti qualche unità di maria, apri l’app, tocca DRUGS, poi Weed, quindi SELL.

Ha funzionato quando sulla mappa compare un percorso rosso con un conto alla rovescia nell’app. Guida fino a lì, avvicinati al marker della porta e premi E: il giocatore bussa, esce un acquirente e il telefono ti dice cosa hai venduto e a quanto. PROFILE ora mostra una vendita.

Prima di aprire la tua città

Reimposta Config.MinimumPolice al valore desiderato per la tua città.
Cancella i progressi di test. player_data.json viene fornito con voci di esempio e conserva quelle dei tuoi test. Elimina il file; la risorsa ne creerà uno vuoto al successivo avvio.
Fai corrispondere ogni nome item in Config.drugs al tuo inventario. Una droga che nessuno può avere in tasca diventa un pulsante che dice solo “Non ne hai abbastanza”.
Controlla l’oggetto denaro per il tuo framework, come spiegato sopra.
Controlla che Config.BlockedAppJobs e Config.PoliceJobs usino i nomi dei lavori del tuo server.