Installation

Cinq minutes. Pas de SQL, aucun fichier d’item à importer : ce dont vous avez besoin, c’est de lb-phone, d’une ligne dans config.lua et de drogues dans votre inventaire que l’application peut vendre.

Avant de commencer

Vous avez besoin	Pourquoi
lb-phone	L’application s’y installe et chaque notification y transite
ESX, QBCore ou QBox	Inventaire, argent, métiers et identité du joueur
Items de drogues dans l’inventaire	L’application vend ce que les joueurs portent ; elle ne crée pas d’items

1. Mettez le dossier en place

Déposez mic_drugdealer dans vos ressources, par exemple dans resources/[mic]/mic_drugdealer.

2. Démarrez-le après lb-phone et votre framework

Dans votre server.cfg, ajoutez ensure mic_drugdealer sur une ligne située en dessous de votre framework et en dessous de lb-phone.

L’application attend lb-phone et se réenregistre d’elle-même dès que lb-phone redémarre, l’ordre est donc souple, mais le framework doit obligatoirement être démarré en premier : le côté serveur l’interroge dès son lancement.

3. La base de données — rien à faire

Les niveaux et le décompte des ventes sont enregistrés dans player_data.json au sein du dossier de la ressource. La ressource crée ce fichier automatiquement s’il est absent. Votre serveur doit disposer des droits d’écriture sur ce dossier.

4. Indiquez votre framework

Ce réglage n’est pas auto-détecté. Ouvrez config.lua et configurez Config.Framework :

Votre framework	Valeur
ESX	`"ESX"`
QBCore	`"QB"`
QBox	`"QB"`

Les majuscules comptent. Si la ressource de votre framework porte un nom personnalisé, modifiez Config.esxResourceName ou Config.qbResourceName en conséquence ; sinon, laissez-les tels quels.

Sur QBox, utilisez "QB" et laissez Config.qbResourceName sur "qb-core" : QBox gère les ressources QBCore via sa couche de compatibilité, et qbx_core fournit l’équivalent de qb-core.

5. Les items

La ressource ne fournit pas de définitions d’items : elle vend des items que votre inventaire connaît déjà. La configuration d’origine attend les noms suivants :

Item	Vendu sous le nom	Zones	Niveau
`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

Vos drogues ont très probablement d’autres noms dans votre inventaire. Modifiez le champ item de chaque entrée dans Config.drugs pour qu’il corresponde à votre inventaire, plutôt que de créer de nouveaux items — voir Personnalisation.

Les items monétaires sont également importants :

ESX avec Config.MoneyAsItem = true verse l’argent sous forme d’item black_money (ou Config.MoneyItem si l’argent sale est désactivé) — idéal pour ox_inventory.
QBCore verse l’argent sale sous forme d’un item nommé blackmoney. Assurez-vous que cet item existe, ou désactivez Config.BlackMoney.

Les illustrations présentes dans ui/img/ sont les icônes de drogues propres à l’application. Ce sont de simples PNG : vous pouvez les copier dans le dossier d’images de votre inventaire si vous souhaitez une cohérence visuelle.

6. Premier test

Réglez Config.MinimumPolice = 0 pour le test — la valeur par défaut est 1, et personne n’achète sans policier en ligne.
Connectez-vous avec un métier qui n’est pas listé dans Config.BlockedAppJobs (police, sheriff, ambulance et mechanic y figurent par défaut).
Ouvrez lb-phone, cherchez Drug Dealer dans l’App Store et installez l’application.
Donnez-vous quelques maria, ouvrez l’application, appuyez sur DRUGS, puis Weed, puis SELL.

Vérification : un itinéraire rouge apparaît sur la carte avec un compte à rebours dans l’application. Rendez-vous sur place en voiture, avancez vers le marqueur de la porte et appuyez sur E : le joueur frappe, un acheteur sort, et le téléphone vous indique ce que vous avez vendu et pour combien. L’onglet PROFILE affiche désormais une vente au compteur.

Avant d’ouvrir votre serveur

Rétablissez Config.MinimumPolice à la valeur souhaitée pour votre ville.
Effacez la progression de test. Le fichier player_data.json est fourni avec des exemples et conserve vos données de test. Supprimez ce fichier ; la ressource en créera un vide lors de son prochain démarrage.
Vérifiez chaque nom d’item dans Config.drugs pour qu’il corresponde à votre inventaire. Une drogue introuvable donne un bouton qui affichera toujours « Vous n’en avez pas assez ».
Vérifiez l’item d’argent correspondant à votre framework (voir ci-dessus).
Vérifiez que Config.BlockedAppJobs et Config.PoliceJobs utilisent bien les noms exacts de vos métiers.