Aller au contenu

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.


FichierCe qu’il décideModifiable ?
config.luaFramework, chemin des images, expiration, paiements, emplacement du pawn shop, marqueur, blip, PNJ, blacklist, textes de notification, nom de l’appOui
pawnshop.sqlLes trois tables, à importer une seule foisOui
web/index.html, web/styles.css, web/script.jsLes écrans de l’application, la disposition et les libellés—
web/assets/pawn.pngL’icône de l’applicationOui
web/assets/fries.pngL’image affichée par défaut lorsqu’un item n’a pas d’illustrationOui
client/main.lua, server/main.luaLa logique interneSous 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.


OptionCe qu’elle faitDéfaut
Config.Framework"esx" ou "qb", en minuscules. Sur QBox, utilisez "qb" — QBox gère les ressources QBCore via sa compatibilité"esx"
Config.InventoryImagePathLe dossier de lecture des images d’items, au format resource/dossier/. Pour qb-inventory, "qb-inventory/html/images/""ox_inventory/web/images/"
Config.ExpireNombre de jours durant lesquels une annonce reste active. Modifier le prix réinitialise le décompte7

OptionCe qu’elle faitDéfaut
Config.Banktrue : les acheteurs paient via leur banque et les vendeurs encaissent sur leur banque. false : paiement via l’item de Config.Moneytrue
Config.MoneyL’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.


OptionCe qu’elle faitDéfaut
Config.RequireLocationtrue : la publication et l’achat d’annonces doivent être finalisés au pawn shopfalse
Config.PawnShopLocationCoordonnées du pawn shop : x, y, z et orientation du PNJ412.17, 315.11, 103.13, orientation 194.62
Config.InteractionDistanceDistance en mètres pour pouvoir appuyer sur E. Le serveur la vérifie également1.0
Config.MarkerMarqueur à la porte : Type, Scale (x, y, z) et Color (r, g, b, a)Type 20, bleu-gris sombre
Config.BlipBlip d’itinéraire : Sprite, Color, Scale480, 32, 1
Config.NPCModè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.


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.


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 :

OptionCe qu’elle contient
Config.locales.en.app_nameNom de l’application sur le téléphone et titre de ses notifications
Config.locales.en.app_descriptionSlogan affiché sous le nom dans l’App Store
Config.MessagesChaque 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.


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.