Installation

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.

Dix minutes : un fichier SQL, une permission et trois lignes de config.lua à vérifier.

---

Avant de commencer

Vous avez besoin de	Pourquoi
ESX, QBCore ou QBox	L’argent, les jobs, les items et les notifications proviennent du framework
oxmysql	Tout ce que les boutiques retiennent se trouve dans votre base de données
ox_target ou qb-target	Optionnel. ox_target est par défaut ; sans aucun des deux, les joueurs voient une invite et appuient sur E
screenshot-basic	Optionnel, pour joindre des captures d’écran aux logs Discord. Requis si Config.Screenshot est actif

---

1. Mettre le dossier en place

Téléchargez mic_shopcreator depuis vos assets accordés Cfx.re et déposez le dossier dans vos ressources, par exemple resources/[mic]/mic_shopcreator.

---

2. Démarrer le script après ses dépendances

Dans server.cfg, ensure mic_shopcreator se place en dessous d’oxmysql, de votre framework (es_extended, qb-core ou qbx_core), de votre inventaire, de votre ressource de target et de screenshot-basic.

Cela fonctionne si la ressource démarre sans lignes rouges et sans message Locale file not found.

---

3. La base de données

Importez mic_shopcreator.sql une seule fois. Il crée neuf tables :

Table	Ce qu’elle contient
mic_shopcreator	Les boutiques, avec leurs paramètres de blip, job, braquage, propriété et webhook
mic_shopcreator_locations	L’emplacement de chaque vendeur, son modèle, ses vêtements et date du dernier braquage
mic_shopcreator_products	Produits des boutiques gérées par le serveur
mic_shopcreator_owner_products	Produits des boutiques possédées par les joueurs, avec leur stock
mic_shopcreator_jobs	Quels jobs et grades peuvent accéder à une boutique
mic_shopcreator_rewards	Butin accordé lors d’un braquage
mic_shopcreator_owners	Qui possède quelle boutique
mic_shopcreator_employees	Qui travaille où, leur commission et leur coffre personnel
mic_shopcreator_vaults	Solde d’argent propre et sale de chaque boutique possédée

Mise à jour depuis une version plus ancienne ? Vous n’avez pas besoin d’update.sql : à chaque démarrage, la ressource vérifie la présence des colonnes ajoutées depuis (clothes sur les emplacements, min_amount et max_amount sur les récompenses) et les crée si elles manquent. La console affiche Added clothes column to mic_shopcreator_locations table. la seule fois où cela se produit.

---

4. Items

Aucun item propre n’est fourni. Une boutique vend des items qui existent déjà dans votre inventaire — vous saisissez leur nom lors de l’ajout d’un produit. Les images de produits sont issues du dossier d’images de votre inventaire, voir étape 5.

---

5. Framework, target et images

Ouvrez config.lua et vérifiez :

Option	Définir sur
Config.Framework	'esx' (par défaut) ou 'qbcore'. Non détecté automatiquement. Sur QBox, utilisez 'qbcore' — QBox gère les ressources QBCore via sa compatibilité
Config.Interaction	'ox_target' (par défaut), 'qb-target' ou 'default' (invite d’aide et E)
Config.InventoryImagePath	Où votre inventaire stocke les images des items. Réglé par défaut sur nui://ox_inventory/web/images/
Config.IdentifierType	Comment les propriétaires et employés sont identifiés. Défini sur 'discord' par défaut ; voir ci-dessous

Config.IdentifierType décide de ce qui est consigné dans la liste des propriétaires et de ce que stocke la table des employés :

Valeur	Les joueurs sont identifiés par	À utiliser si
'discord'	Leur identifiant Discord, le numéro sans discord:	Tout le monde se connecte avec Discord lié
'license'	Leur licence Rockstar, le préfixe license:… inclus	Vous n’exigez pas Discord
'esx'	L’identifiant propre à ESX, préfixe de personnage inclus	ESX avec multi-personnage, pour séparer les possessions
'citizenid'	Le citizen ID de QBCore	QBCore ou QBox, pour séparer les possessions par personnage

Choisissez ce paramètre avant que quiconque ne devienne propriétaire ou employé d’une boutique. Le changer plus tard vous obligera à redéfinir chaque propriétaire, et les employés actuels ne seront plus reconnus.

---

6. Vous attribuer l’accès au panneau

Le panneau est verrouillé derrière la permission ACE mic_shop.open (et non mic_shopcreator.open). Accordez-la dans votre server.cfg avec une ligne add_ace — à un individu, par exemple add_ace identifier.discord:VOTRE_ID_DISCORD mic_shop.open allow, ou à un groupe, par exemple add_ace group.admin mic_shop.open allow.

Cela fonctionne si /shopcreator ouvre le Shop Creator. Sans la permission, vous recevrez la notification « pas de permission ».

---

7. Premier test

1. Tapez /shopcreator, créez une boutique et donnez-lui un nom.
2. Ajoutez un emplacement. Un aperçu du vendeur suit votre regard : la molette le fait pivoter, ↑ / ↓ le montent ou le descendent, E le pose et X annule.
3. Ajoutez un produit : un item existant dans votre inventaire, un prix, une catégorie et un mode de paiement. Enregistrez.

Cela fonctionne si le vendeur se tient à l’endroit désigné, lui parler ouvre la boutique avec votre produit et son image, et acheter l’article retire l’argent et vous donne l’item.

---

Avant d’ouvrir votre ville

• Config.IdentifierType est définitif. Décidez-le maintenant ; les propriétaires et employés sont indexés dessus.
• Seuls les admins doivent posséder mic_shop.open. Cette permission permet de créer, modifier et supprimer toutes les boutiques.
• Laissez Config.Screenshot actif uniquement si screenshot-basic tourne. Sinon, les logs ne s’enverront pas.
• Les cooldowns de braquage se configurent par boutique, en minutes — attribuez-en un à chaque boutique braquable.
• Achetez un article avec un personnage normal dans chaque boutique soumise à restriction de métier, pour valider le grade configuré.