Personnalisation
Un seul fichier régit tout ce que vous pouvez modifier : config.lua. Le reste est constitué des écrans de l’application et de la logique sous escrow.
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, chemin des images, expiration, paiements, emplacement du pawn shop, marqueur, blip, PNJ, blacklist, textes de notification, nom de l’app | Oui |
pawnshop.sql | Les trois tables, à importer une seule fois | Oui |
web/index.html, web/styles.css, web/script.js | Les écrans de l’application, la disposition et les libellés | — |
web/assets/pawn.png | L’icône de l’application | Oui |
web/assets/fries.png | L’image affichée par défaut lorsqu’un item n’a pas d’illustration | Oui |
client/main.lua, server/main.lua | La logique interne | Sous escrow |
Il n’y a pas de dossier bridge ni de dossier locales : le framework est une simple option ci-dessous et les textes résident dans config.lua.
| Option | Ce qu’elle fait | Défaut |
|---|---|---|
Config.Framework | "esx" ou "qb", en minuscules. Sur QBox, utilisez "qb" — QBox gère les ressources QBCore via sa compatibilité | "esx" |
Config.InventoryImagePath | Le dossier de lecture des images d’items, au format resource/dossier/. Pour qb-inventory, "qb-inventory/html/images/" | "ox_inventory/web/images/" |
Config.Expire | Nombre de jours durant lesquels une annonce reste active. Modifier le prix réinitialise le décompte | 7 |
Paiements
Section intitulée « Paiements »| Option | Ce qu’elle fait | Défaut |
|---|---|---|
Config.Bank | true : les acheteurs paient via leur banque et les vendeurs encaissent sur leur banque. false : paiement via l’item de Config.Money | true |
Config.Money | L’item d’inventaire utilisé comme monnaie lorsque Bank est désactivé — money, black_money ou votre propre item | "money" |
Lorsque Bank est désactivé (false), l’argent doit impérativement être un item d’inventaire, ce qui correspond au fonctionnement de l’argent liquide sur ox_inventory. Sur l’inventaire par défaut d’ESX et sur QBCore, l’argent liquide est géré comme un compte et non comme un item ; laissez donc Config.Bank = true dans ces environnements.
L’argent issu d’une vente ne parvient pas directement au vendeur. Il est crédité sur son solde Pending dans l’application, et le joueur doit appuyer sur le bouton de transfert pour le récupérer.
Vente physique au comptoir
Section intitulée « Vente physique au comptoir »| Option | Ce qu’elle fait | Défaut |
|---|---|---|
Config.RequireLocation | true : la publication et l’achat d’annonces doivent être finalisés au pawn shop | false |
Config.PawnShopLocation | Coordonnées du pawn shop : x, y, z et orientation du PNJ | 412.17, 315.11, 103.13, orientation 194.62 |
Config.InteractionDistance | Distance en mètres pour pouvoir appuyer sur E. Le serveur la vérifie également | 1.0 |
Config.Marker | Marqueur à la porte : Type, Scale (x, y, z) et Color (r, g, b, a) | Type 20, bleu-gris sombre |
Config.Blip | Blip d’itinéraire : Sprite, Color, Scale | 480, 32, 1 |
Config.NPC | Modèle de ped du vendeur (Model) et animation d’échange (Dict et Name) | a_m_m_business_01, mp_common / givetake1_a |
Déroulement du jeu lorsque RequireLocation est activé : le joueur remplit l’annonce ou clique sur acheter, le téléphone trace un itinéraire vers le pawn shop, et le marqueur apparaît lorsqu’il se trouve à moins de 20 mètres. Appuyer sur E devant le marqueur fait intervenir le PNJ pour l’échange de la marchandise et la transaction se conclut.
Le blip et le marqueur n’existent que tant que le joueur a une opération à finaliser sur place ; il n’y a pas de blip permanent sur la carte. Lorsque RequireLocation est désactivé, aucun de ces éléments n’est utilisé.
Config.Blip.Name n’est pas utilisé pour le libellé du blip — celui-ci provient de Config.Messages.blip_name.
Blacklist
Section intitulée « Blacklist »Config.BlackList est une liste de noms d’items qui ne peuvent jamais être mis en vente. Ils sont masqués dans le sélecteur d’items, refusés par le serveur, et toute offre existante les concernant est immédiatement retirée du tableau — avec ses items — dès la prochaine ouverture de l’application par un joueur. Fournie avec burger et weapon_appistol comme exemples.
Textes et langues
Section intitulée « Textes et langues »Il n’y a pas de dossier de locales dédié. L’intégralité des textes modifiables se trouve dans config.lua, en anglais par défaut :
| Option | Ce qu’elle contient |
|---|---|
Config.locales.en.app_name | Nom de l’application sur le téléphone et titre de ses notifications |
Config.locales.en.app_description | Slogan affiché sous le nom dans l’App Store |
Config.Messages | Chaque notification : offre créée, achetée et supprimée, champs manquants, échecs, “allez au pawn shop”, invite de la touche E et nom du blip |
Pour proposer une autre langue, traduisez directement ces chaînes dans le fichier. Quelques réponses du serveur — “Insufficient items”, “Inventory full”, “This item cannot be listed for sale”, “You do not own this offer” et équivalents — sont codées en dur dans le fichier serveur sous escrow et restent en anglais.
Sur ESX, les notifications parviennent sous forme de notifications lb-phone émises par l’application. Sur QBCore, elles utilisent le système de notification natif du framework.
Images des items
Section intitulée « Images des items »L’application affiche chaque item via <Config.InventoryImagePath><item name>.png, lu directement depuis votre ressource d’inventaire. Si une image est manquante, web/assets/fries.png est affichée comme solution de secours ; remplacez ce fichier si vous souhaitez modifier l’image par défaut.