Personnalisation
Chaque boutique est configurée dans le panneau et stockée dans votre base de données — voir 🏪 Créer une boutique. Les fichiers régissent ce que toutes les boutiques ont en commun.
Quel fichier décide de quoi
Section intitulée « Quel fichier décide de quoi »| Fichier | Ce qu’il décide | Ouvert ? |
|---|---|---|
config.lua | Framework, langue, interaction, ped par défaut, commande, images, catégories, règles de braquage, identifiants | Oui |
bridge/server.lua | Argent, comptes, items, inventaire, jobs, notifications, callbacks, et alerte de police personnalisée | Oui |
bridge/client.lua | Notifications, invites d’aide, données du joueur et callbacks côté client | Oui |
bridge/target.lua | Comment les vendeurs et points de vente sont injectés dans ox_target ou qb-target | Oui |
bridge/utils.lua | Lit les identifiants d’un joueur (Steam, licence, Discord, FiveM, Xbox) | Oui |
locales/*.lua | Textes en jeu : notifications, invites d’interaction, messages de braquage | Oui |
html/locales.js | Textes au sein des panneaux et de la fenêtre de boutique, pour les douze langues | Lisible |
html/index.html, style.css, script.js | Les panneaux et la fenêtre de boutique | Lisible |
list/peds.lua | Modèles de peds proposés dans le panneau | Sous escrow |
mic_shopcreator.sql | Les neuf tables, importées une seule fois | Oui |
client.lua, server.lua | Logique des boutiques | Sous escrow |
config.lua
Section intitulée « config.lua »| Option | Ce qu’elle fait | Par défaut |
|---|---|---|
Config.Locale | La langue, en jeu et dans les panneaux. Voir Langues | 'en' |
Config.Framework | 'esx' ou 'qbcore'. Non détecté automatiquement. Sur QBox, utilisez 'qbcore' — QBox gère les ressources QBCore via sa couche de compatibilité | 'esx' |
Config.Command | La commande ouvrant le panneau du Shop Creator | 'shopcreator' |
Config.IdentifierType | Comment les propriétaires et employés sont identifiés : 'discord', 'license', 'esx' ou 'citizenid'. Voir Installation | 'discord' |
Vendeurs et interaction
Section intitulée « Vendeurs et interaction »| Option | Ce qu’elle fait | Par défaut |
|---|---|---|
Config.Interaction | 'ox_target', 'qb-target' ou 'default' (invite d’aide et E) | 'ox_target' |
Config.RadiusInteract | Avec 'default', distance en mètres pour pouvoir interagir | 2.0 |
Config.SpawnNPC | false ne fait apparaître aucun vendeur : un marqueur (avec 'default') ou une sphère target marque l’endroit. Pas de vendeur = personne à braquer | true |
Config.DefaultPed | Modèle utilisé si un emplacement n’en a pas, ou en a un invalide | 'a_f_m_bevhills_01' |
Config.PedSpawnDistance | Les vendeurs n’existent que lorsqu’un joueur se trouve à moins de cette distance en mètres | 20.0 |
Produits
Section intitulée « Produits »| Option | Ce qu’elle fait | Par défaut |
|---|---|---|
Config.Categories | Catégories proposées lors de l’ajout d’un produit ; la fenêtre de boutique regroupe les produits selon celles-ci | items, weapons, misc |
Config.InventoryImagePath | Liste de dossiers d’images. Pour chaque produit, la fenêtre tente <nom_item>.png dans chaque dossier successivement et affiche le premier valide | nui://ox_inventory/web/images/ |
Config.AllowEmployeesAddProducts | Dans les boutiques possédées, autorise ou non les employés à ajouter de nouveaux produits. Les propriétaires le peuvent toujours | false |
Vous n’utilisez pas ox_inventory ? Faites pointer Config.InventoryImagePath vers le dossier d’images de votre inventaire, par exemple nui://qb-inventory/html/images/. Ajoutez une seconde entrée si vos images sont réparties dans plusieurs dossiers.
Braquages
Section intitulée « Braquages »| Option | Ce qu’elle fait | Par défaut |
|---|---|---|
Config.BlacklistWeapons | Conçu pour interdire certaines armes. Cette version ne le lit pas : n’importe quelle arme déclenche un braquage, seules les mains nues n’en lancent pas | weapon_unarmed, weapon_nightstick, weapon_stungun |
Config.RobberyNotifyJobs | Métiers alertés lorsqu’un braquage débute | police |
Config.PoliceAlert | "default" alerte les métiers ci-dessus avec notification et blip pendant 1 minute. "custom" appelle TriggerPoliceAlert dans bridge/server.lua à la place | "default" |
Config.RobberyCooldown | Temps de recharge par défaut si aucun n’est configuré sur la boutique. Compté en minutes (le commentaire de config.lua mentionne des secondes) | 300 |
Config.TakeRobberyMoneyFromVault | Dans les boutiques possédées, l’argent dérobé est prélevé du coffre-fort — et s’arrête lorsqu’il est vide | true |
| Option | Ce qu’elle fait | Par défaut |
|---|---|---|
Config.Screenshot | Joint une capture d’écran du joueur aux logs Discord. Nécessite screenshot-basic en fonctionnement | true |
L’URL du webhook se définit par boutique dans le panneau, pas ici.
Commandes et permissions
Section intitulée « Commandes et permissions »| Commande | Qui peut l’utiliser | Ce qu’elle fait |
|---|---|---|
/shopcreator | ACE mic_shop.open | Ouvre le panneau du Shop Creator. Renommable via Config.Command, et assignable à une touche FiveM comme toute commande |
Les propriétaires et employés n’ont besoin d’aucune permission : la fenêtre de boutique leur affiche une icône d’engrenage vers les Paramètres de la boutique lorsqu’ils ouvrent une boutique qu’ils possèdent ou où ils travaillent.
Douze langues sont fournies : en, es, fr, de, it, pt, ru, ja, ko, zh-CN, ar et nl. Les textes sont répartis en deux endroits régis par Config.Locale :
locales/<code>.lua— ce que le jeu affiche : notifications, textes d’aide, messages de braquage.html/locales.js— ce que les panneaux et la fenêtre de boutique affichent, un bloc par langue.
Ajouter une langue :
- Copiez
locales/en.luaverslocales/<code>.luaet traduisez le texte sur la droite de chaque ligne. Conservez les clés et les éventuels%s. - Ajoutez
locales/<code>.luaàshared_scriptsdansfxmanifest.lua, aux côtés des autres, afin que les clients le téléchargent. - Dans
html/locales.js, copiez le bloc'en', renommez-le avec votre code, puis traduisez-le. - Réglez
Config.Localesur votre code, faitesrefresh, puis redémarrez.
Une clé manquante dans votre fichier Lua s’affichera en jeu sous la forme Translation not found: <key>.
Le bridge
Section intitulée « Le bridge »Quatre fichiers ouverts se trouvent dans bridge/. Ne modifiez pas les noms de fonctions — le code du script les appelle directement par leur nom.
bridge/server.lua — un bloc pour ESX, un pour QBCore, sélectionné selon Config.Framework.
| Fonction | À quoi elle sert |
|---|---|
GetPlayer, GetPlayerJob | L’objet joueur et son job |
GetMoney, AddMoney, RemoveMoney | Argent liquide |
GetAccount, AddAccountMoney, RemoveAccountMoney | Comptes nommés : bank, black_money |
GetInventoryItem, AddInventoryItem, RemoveInventoryItem | Items. Lit à travers ox_inventory lorsqu’il est actif |
GetPlayerInventory | Inventaire du propriétaire, listé lorsqu’il approvisionne sa boutique |
ShowNotification | Notifications côté serveur |
RegisterServerCallback | Callbacks via ESX ou QBCore |
TriggerPoliceAlert(x, y, z, shopLabel) | Appelé lors de chaque braquage quand Config.PoliceAlert = "custom". Vide par défaut — insérez votre dispatch |
bridge/client.lua — ShowNotification, ShowHelpNotification, GetPlayerData et TriggerServerCallback. Sur QBCore, ShowHelpNotification est vide ; remplissez-le avec votre propre système d’aide ou de texte à l’écran si vous utilisez Config.Interaction = 'default' ou souhaitez voir l’invite d’embauche d’employé.
bridge/target.lua — ajoute l’option « ouvrir la boutique » à chaque vendeur (ou à une sphère quand Config.SpawnNPC est désactivé) pour ox_target ou qb-target, et la retire lors des modifications.
Dispatch de police sur mesure : définissez Config.PoliceAlert = "custom" et écrivez l’alerte de votre ressource de dispatch dans TriggerPoliceAlert au sein de bridge/server.lua. Elle reçoit les coordonnées du vendeur et le nom de la boutique.
Exports client pour ouvrir des boutiques depuis une autre ressource :
| Export | Arguments | Ce qu’il fait |
|---|---|---|
OpenShop | shop ID, location ID | Ouvre la fenêtre de cette boutique, en respectant son cooldown et ses restrictions de job |
OpenShopAsEmployee | shop ID, location ID | Identique à OpenShop ; l’engrenage des réglages apparaît si le joueur y travaille |
OpenShopAsOwner | — | Ouvre le panneau du Shop Creator si le joueur a la permission mic_shop.open |
Les ressources de target peuvent aussi déclencher l’événement client mic_shopcreator:client:openShop avec shopId et locationId dans les données, ce qui correspond au comportement interne des options de target. Les identifiants de boutique et de lieu sont ceux visibles dans le panneau.