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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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 = trueverse l’argent sous forme d’itemblack_money(ouConfig.MoneyItemsi 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ésactivezConfig.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
Section intitulée « 6. Premier test »- Réglez
Config.MinimumPolice = 0pour le test — la valeur par défaut est1, 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
Section intitulée « 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.jsonest 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’
itemdansConfig.drugspour 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.BlockedAppJobsetConfig.PoliceJobsutilisent bien les noms exacts de vos métiers.