Personnalisation

Note

💬 Besoin d’aide ? Le support, les mises à jour et les changelogs sont sur le Discord de Mic Scripts. Ouvrez un ticket avec votre ID de transaction Tebex et l’erreur console.

Tout ce que vous pouvez personnaliser se trouve dans config.lua et dans locales/. Le reste de la ressource est sous escrow, à l’exception des écrans de l’application mobile.

---

Quel fichier décide de quoi

Fichier	Ce qu’il décide	Modifiable ?
config.lua	Framework, argent, taux d’échec, police, fiche App Store, drogues, niveaux, zones	Oui
locales/*.lua	Les notifications du téléphone, un fichier par langue	Oui
locales/locales.lua	La table de locales que les fichiers de langues remplissent	Oui
ui/img/	Les images de l’application : une par drogue, le logo d’accueil et l’icône (icon.png)	Oui
ui/index.html, ui/styles.css, ui/script.js	Les écrans de l’application, la disposition et le texte des boutons	—
player_data.json	Les ventes, niveaux et bonus de chaque dealer. Écrit par la ressource	Oui
client/, server/	La logique interne	Sous escrow

Il n’y a pas de dossier bridge séparé : le framework se choisit directement via Config.Framework ci-dessous.

---

Framework et argent

Option	Ce qu’elle fait	Défaut
Config.Framework	"ESX" ou "QB", en majuscules. Sur QBox, utilisez "QB" — QBox gère les ressources QBCore via sa compatibilité	"ESX"
Config.esxResourceName	Le nom de ressource d’ESX, si le vôtre n’est pas le standard	"es_extended"
Config.qbResourceName	Le nom de ressource de QBCore, si le vôtre n’est pas le standard. Laissez "qb-core" sur QBox	"qb-core"
Config.BlackMoney	Payer en argent sale plutôt qu’en argent propre	true
Config.MoneyAsItem	Payer sous forme d’item d’inventaire plutôt que sur un compte bancaire	true
Config.MoneyItem	L’item payé lorsque MoneyAsItem est activé et que BlackMoney est désactivé	"money"

Ce que reçoit réellement le joueur :

	ESX	QBCore / QBox
Argent sale, en item	Item black_money	Item blackmoney
Argent sale, en compte	Compte black_money	Item blackmoney
Argent propre, en item	Item de Config.MoneyItem	Item de Config.MoneyItem
Argent propre, en compte	Cash (liquide)	Cash (liquide)

---

Le deal

Option	Ce qu’elle fait	Défaut
Config.Failure	Le pourcentage de chance (0 à 100) que l’acheteur rejette le joueur après qu’il a frappé. Le joueur garde sa marchandise	55
Config.DealTimeout	Nombre de secondes pour atteindre la porte avant expiration de l’offre	300
Config.MinimumPolice	Nombre de policiers en ligne requis avant que quiconque n’achète. 0 désactive la vérification	1

La quantité vendue est tirée au sort entre minAmount et maxAmount de la drogue concernée dès que le joueur appuie sur SELL ; la porte est tirée au sort parmi les zones associées à cette drogue.

---

La police

Option	Ce qu’elle fait	Défaut
Config.PoliceJobs	Métiers comptabilisés comme policiers et recevant les alertes	police, sheriff
Config.PoliceAlertChance	Pourcentage de chance (0 à 100) qu’une vente réussie soit signalée	20
Config.PoliceNotifyAppName	Titre de l’alerte sur le lb-phone des policiers	"Police Dispatch"
Config.PoliceBlipSprite	L’icône de blip placée à l’endroit de la vente	161
Config.PoliceBlipColor	Sa couleur	38
Config.PoliceBlipScale	Sa taille	1.0
Config.PoliceBlipDuration	Durée en secondes avant disparition du blip	120
Config.PriceMultipliers	Paliers de prix selon le nombre de policiers en ligne, avec minPolice, maxPolice et multiplier	Voir ci-dessous

Paliers par défaut : 1–2 policiers ×1.0, 3–4 ×1.2, 5–6 ×1.4, 7–9 ×1.6, 10 ou plus ×2.0. Si le nombre de policiers ne correspond à aucun palier, le multiplicateur reste à ×1.0.

Calcul du prix final : Le bonus de niveau et le bonus de police sont additionnés, et non multipliés : un dealer de niveau 5 (×1.5) vendant avec six policiers en ligne (×1.4) reçoit 1 + 0.5 + 0.4 = ×1.9 le prix de base.

Chaque agent exerçant un métier présent dans PoliceJobs reçoit l’alerte ; il n’y a pas de vérification de prise de service.

---

Qui voit l’application

Option	Ce qu’elle fait	Défaut
Config.BlockedAppJobs	Métiers ne pouvant ni voir ni installer l’application. Vérifié au chargement du joueur et à chaque changement de métier	police, sheriff, ambulance, mechanic

---

La fiche App Store

Option	Ce qu’elle fait	Défaut
Config.name	Nom de l’application sur le téléphone	"Drug Dealer"
Config.description	Slogan affiché sous le nom dans l’App Store	"Deal dope, dodge the cops"
Config.defaultApp	true préinstalle l’application sur tous les téléphones ; false nécessite de la télécharger	false
Config.size	Taille affichée dans le store, en Ko	25400
Config.price	Coût d’installation	0

L’icône de l’application est ui/img/icon.png. Remplacez ce fichier pour la changer.

---

Drogues

Config.drugs est une liste ; chaque entrée représente un bouton dans l’application.

Champ	Ce qu’il fait
item	L’item d’inventaire qui est vendu
label	Le nom affiché dans l’application et les notifications
price	Prix par unité, avant application des bonus
minAmount, maxAmount	Plage de quantité tirée pour chaque deal
zones	Zones de Config.NPCLocations où un acheteur peut se trouver
image	Nom de fichier dans ui/img/
minLevel	Niveau de dealer requis pour pouvoir la vendre

Pour ajouter une drogue, ajoutez une entrée, placez son image dans ui/img/, et assurez-vous que l’item existe dans votre inventaire. Images fournies et utilisées par la liste d’origine : baggy_weed.png, baggy_cocaine.png, lsd.png, baggy_meth.png, mushroom.png, opium.png, crack.png, drug_heroin.png, xtc_baggy.png, oxy.png, drug_lean.png, drug_hash.png.

---

Niveaux

Config.levels liste les rangs dans l’ordre. Chacun possède un numéro level, un nom name, un nombre de salesRequired (le nombre total de ventes, pas d’unités) et un bonusMultiplier.

Niveau	Nom	Ventes	Bonus
1	Newbie	0	×1.0
2	Rookie	25	×1.1
3	Hustler	75	×1.2
4	Dealer	150	×1.35
5	Trader	300	×1.5
6	Boss	600	×1.75
7	Kingpin	1200	×2.0
8	Overlord	2000	×2.25
9	Tycoon	3500	×2.5
10	Legend	5000	×3.0

Conservez-les par ordre croissant de salesRequired ; le niveau est calculé en parcourant la liste.

Option	Ce qu’elle fait	Défaut
Config.dataFile	Fichier dans le dossier de la ressource stockant la progression des dealers	"player_data.json"

La progression est conservée par personnage : identifiant ESX ou Citizen ID QBCore.

---

Zones

Config.NPCLocations est numéroté ; ces numéros correspondent aux zones référencées dans le champ zones des drogues. Chaque zone contient :

Champ	Ce qu’il fait
peds	Modèles de peds, l’un étant choisi au hasard pour ouvrir
locations	Positions des portes (x, y, z et orientation)

Zone	Quartier	Portes fournies
1	Grove	1
2	Ponton et plage	10
3	Maisons Vinewood	10
4	Sandy Shores	8
5	Paleto Bay	9

Vous pouvez librement ajouter des zones et des portes. Détail important : le nom de zone affiché dans l’alerte de police provient du code interne de la ressource qui ne connaît que les zones 1 à 5 ; toute nouvelle zone sera signalée sous l’appellation “Unknown Zone”.

---

Langues

Neuf langues sont fournies dans locales/ : en, es, fr, de, it, pt, pl, ru et tr. Définissez Config.Locale sur l’une d’elles.

Pour en ajouter une :

1. Copiez locales/en.lua vers un nouveau fichier, par exemple locales/nl.lua.
2. Modifiez le code au début du fichier en nl et traduisez les textes.
3. Ajoutez locales/nl.lua à la liste shared_scripts dans fxmanifest.lua, aux côtés des autres et au-dessus de config.lua.
4. Définissez Config.Locale = "nl", puis faites refresh et redémarrez la ressource.

Les fichiers de locales couvrent les notifications téléphoniques. Les boutons de l’application elle-même — DRUGS, PROFILE, SELL, CANCEL et l’écran de profil — sont écrits en dur dans ui/script.js et ui/index.html.