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.

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

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.

---

Général

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

Danger

Une annonce expirée est définitivement supprimée avec ses items. Ils ne sont pas restitués au vendeur. Choisissez Config.Expire en ayant cela à l’esprit, et prévenez vos joueurs.

---

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

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

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

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

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.