Personnalisation
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
Section intitulée « 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
Section intitulée « 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) |
| 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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.
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.
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.
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”.
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 :
- Copiez
locales/en.luavers un nouveau fichier, par exemplelocales/nl.lua. - Modifiez le code au début du fichier en
nlet traduisez les textes. - Ajoutez
locales/nl.luaà la listeshared_scriptsdansfxmanifest.lua, aux côtés des autres et au-dessus deconfig.lua. - Définissez
Config.Locale = "nl", puis faitesrefreshet 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.