Aller au contenu

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.


FichierCe qu’il décideOuvert ?
config.luaFramework, langue, interaction, ped par défaut, commande, images, catégories, règles de braquage, identifiantsOui
bridge/server.luaArgent, comptes, items, inventaire, jobs, notifications, callbacks, et alerte de police personnaliséeOui
bridge/client.luaNotifications, invites d’aide, données du joueur et callbacks côté clientOui
bridge/target.luaComment les vendeurs et points de vente sont injectés dans ox_target ou qb-targetOui
bridge/utils.luaLit les identifiants d’un joueur (Steam, licence, Discord, FiveM, Xbox)Oui
locales/*.luaTextes en jeu : notifications, invites d’interaction, messages de braquageOui
html/locales.jsTextes au sein des panneaux et de la fenêtre de boutique, pour les douze languesLisible
html/index.html, style.css, script.jsLes panneaux et la fenêtre de boutiqueLisible
list/peds.luaModèles de peds proposés dans le panneauSous escrow
mic_shopcreator.sqlLes neuf tables, importées une seule foisOui
client.lua, server.luaLogique des boutiquesSous escrow

OptionCe qu’elle faitPar défaut
Config.LocaleLa 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.CommandLa commande ouvrant le panneau du Shop Creator'shopcreator'
Config.IdentifierTypeComment les propriétaires et employés sont identifiés : 'discord', 'license', 'esx' ou 'citizenid'. Voir Installation'discord'
OptionCe qu’elle faitPar défaut
Config.Interaction'ox_target', 'qb-target' ou 'default' (invite d’aide et E)'ox_target'
Config.RadiusInteractAvec 'default', distance en mètres pour pouvoir interagir2.0
Config.SpawnNPCfalse ne fait apparaître aucun vendeur : un marqueur (avec 'default') ou une sphère target marque l’endroit. Pas de vendeur = personne à braquertrue
Config.DefaultPedModèle utilisé si un emplacement n’en a pas, ou en a un invalide'a_f_m_bevhills_01'
Config.PedSpawnDistanceLes vendeurs n’existent que lorsqu’un joueur se trouve à moins de cette distance en mètres20.0
OptionCe qu’elle faitPar défaut
Config.CategoriesCatégories proposées lors de l’ajout d’un produit ; la fenêtre de boutique regroupe les produits selon celles-ciitems, weapons, misc
Config.InventoryImagePathListe de dossiers d’images. Pour chaque produit, la fenêtre tente <nom_item>.png dans chaque dossier successivement et affiche le premier validenui://ox_inventory/web/images/
Config.AllowEmployeesAddProductsDans les boutiques possédées, autorise ou non les employés à ajouter de nouveaux produits. Les propriétaires le peuvent toujoursfalse

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.

OptionCe qu’elle faitPar défaut
Config.BlacklistWeaponsConç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 pasweapon_unarmed, weapon_nightstick, weapon_stungun
Config.RobberyNotifyJobsMétiers alertés lorsqu’un braquage débutepolice
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.RobberyCooldownTemps 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.TakeRobberyMoneyFromVaultDans les boutiques possédées, l’argent dérobé est prélevé du coffre-fort — et s’arrête lorsqu’il est videtrue
OptionCe qu’elle faitPar défaut
Config.ScreenshotJoint une capture d’écran du joueur aux logs Discord. Nécessite screenshot-basic en fonctionnementtrue

L’URL du webhook se définit par boutique dans le panneau, pas ici.


CommandeQui peut l’utiliserCe qu’elle fait
/shopcreatorACE mic_shop.openOuvre 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 :

  1. Copiez locales/en.lua vers locales/<code>.lua et traduisez le texte sur la droite de chaque ligne. Conservez les clés et les éventuels %s.
  2. Ajoutez locales/<code>.lua à shared_scripts dans fxmanifest.lua, aux côtés des autres, afin que les clients le téléchargent.
  3. Dans html/locales.js, copiez le bloc 'en', renommez-le avec votre code, puis traduisez-le.
  4. Réglez Config.Locale sur votre code, faites refresh, puis redémarrez.

Une clé manquante dans votre fichier Lua s’affichera en jeu sous la forme Translation not found: <key>.


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, GetPlayerJobL’objet joueur et son job
GetMoney, AddMoney, RemoveMoneyArgent liquide
GetAccount, AddAccountMoney, RemoveAccountMoneyComptes nommés : bank, black_money
GetInventoryItem, AddInventoryItem, RemoveInventoryItemItems. Lit à travers ox_inventory lorsqu’il est actif
GetPlayerInventoryInventaire du propriétaire, listé lorsqu’il approvisionne sa boutique
ShowNotificationNotifications côté serveur
RegisterServerCallbackCallbacks 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 :

ExportArgumentsCe qu’il fait
OpenShopshop ID, location IDOuvre la fenêtre de cette boutique, en respectant son cooldown et ses restrictions de job
OpenShopAsEmployeeshop ID, location IDIdentique à 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.