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.

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

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

Général

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

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

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

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

Logs

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

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.

---

Langues

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>.

---

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

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.