Installation
Dix minutes : un fichier SQL, une permission et trois lignes de config.lua à vérifier.
Avant de commencer
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 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
Section intitulée « 7. Premier test »- Tapez
/shopcreator, créez une boutique et donnez-lui un nom. - 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.
- 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
Section intitulée « Avant d’ouvrir votre ville »Config.IdentifierTypeest 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.Screenshotactif uniquement siscreenshot-basictourne. 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é.