Aller au contenu

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.


FichierCe qu’il décideModifiable ?
config.luaFramework, argent, taux d’échec, police, fiche App Store, drogues, niveaux, zonesOui
locales/*.luaLes notifications du téléphone, un fichier par langueOui
locales/locales.luaLa table de locales que les fichiers de langues remplissentOui
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.jsLes écrans de l’application, la disposition et le texte des boutons—
player_data.jsonLes ventes, niveaux et bonus de chaque dealer. Écrit par la ressourceOui
client/, server/La logique interneSous escrow

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


OptionCe qu’elle faitDéfaut
Config.Framework"ESX" ou "QB", en majuscules. Sur QBox, utilisez "QB" — QBox gère les ressources QBCore via sa compatibilité"ESX"
Config.esxResourceNameLe nom de ressource d’ESX, si le vôtre n’est pas le standard"es_extended"
Config.qbResourceNameLe nom de ressource de QBCore, si le vôtre n’est pas le standard. Laissez "qb-core" sur QBox"qb-core"
Config.BlackMoneyPayer en argent sale plutôt qu’en argent propretrue
Config.MoneyAsItemPayer sous forme d’item d’inventaire plutôt que sur un compte bancairetrue
Config.MoneyItemL’item payé lorsque MoneyAsItem est activé et que BlackMoney est désactivé"money"

Ce que reçoit réellement le joueur :

ESXQBCore / QBox
Argent sale, en itemItem black_moneyItem blackmoney
Argent sale, en compteCompte black_moneyItem blackmoney
Argent propre, en itemItem de Config.MoneyItemItem de Config.MoneyItem
Argent propre, en compteCash (liquide)Cash (liquide)

OptionCe qu’elle faitDéfaut
Config.FailureLe pourcentage de chance (0 à 100) que l’acheteur rejette le joueur après qu’il a frappé. Le joueur garde sa marchandise55
Config.DealTimeoutNombre de secondes pour atteindre la porte avant expiration de l’offre300
Config.MinimumPoliceNombre de policiers en ligne requis avant que quiconque n’achète. 0 désactive la vérification1

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.


OptionCe qu’elle faitDéfaut
Config.PoliceJobsMétiers comptabilisés comme policiers et recevant les alertespolice, sheriff
Config.PoliceAlertChancePourcentage de chance (0 à 100) qu’une vente réussie soit signalée20
Config.PoliceNotifyAppNameTitre de l’alerte sur le lb-phone des policiers"Police Dispatch"
Config.PoliceBlipSpriteL’icône de blip placée à l’endroit de la vente161
Config.PoliceBlipColorSa couleur38
Config.PoliceBlipScaleSa taille1.0
Config.PoliceBlipDurationDurée en secondes avant disparition du blip120
Config.PriceMultipliersPaliers de prix selon le nombre de policiers en ligne, avec minPolice, maxPolice et multiplierVoir 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.


OptionCe qu’elle faitDéfaut
Config.BlockedAppJobsMétiers ne pouvant ni voir ni installer l’application. Vérifié au chargement du joueur et à chaque changement de métierpolice, sheriff, ambulance, mechanic

OptionCe qu’elle faitDéfaut
Config.nameNom de l’application sur le téléphone"Drug Dealer"
Config.descriptionSlogan affiché sous le nom dans l’App Store"Deal dope, dodge the cops"
Config.defaultApptrue préinstalle l’application sur tous les téléphones ; false nécessite de la téléchargerfalse
Config.sizeTaille affichée dans le store, en Ko25400
Config.priceCoût d’installation0

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.

ChampCe qu’il fait
itemL’item d’inventaire qui est vendu
labelLe nom affiché dans l’application et les notifications
pricePrix par unité, avant application des bonus
minAmount, maxAmountPlage de quantité tirée pour chaque deal
zonesZones de Config.NPCLocations où un acheteur peut se trouver
imageNom de fichier dans ui/img/
minLevelNiveau 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.

NiveauNomVentesBonus
1Newbie0×1.0
2Rookie25×1.1
3Hustler75×1.2
4Dealer150×1.35
5Trader300×1.5
6Boss600×1.75
7Kingpin1200×2.0
8Overlord2000×2.25
9Tycoon3500×2.5
10Legend5000×3.0

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

OptionCe qu’elle faitDéfaut
Config.dataFileFichier 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 :

ChampCe qu’il fait
pedsModèles de peds, l’un étant choisi au hasard pour ouvrir
locationsPositions des portes (x, y, z et orientation)
ZoneQuartierPortes fournies
1Grove1
2Ponton et plage10
3Maisons Vinewood10
4Sandy Shores8
5Paleto Bay9

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 :

  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.