Aller au contenu

Installation

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


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

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.


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.


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

TableCe qu’elle contient
mic_shopcreatorLes boutiques, avec leurs paramètres de blip, job, braquage, propriété et webhook
mic_shopcreator_locationsL’emplacement de chaque vendeur, son modèle, ses vêtements et date du dernier braquage
mic_shopcreator_productsProduits des boutiques gérées par le serveur
mic_shopcreator_owner_productsProduits des boutiques possédées par les joueurs, avec leur stock
mic_shopcreator_jobsQuels jobs et grades peuvent accéder à une boutique
mic_shopcreator_rewardsButin accordé lors d’un braquage
mic_shopcreator_ownersQui possède quelle boutique
mic_shopcreator_employeesQui travaille où, leur commission et leur coffre personnel
mic_shopcreator_vaultsSolde 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.


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.


Ouvrez config.lua et vérifiez :

OptionDé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.InventoryImagePathOù votre inventaire stocke les images des items. Réglé par défaut sur nui://ox_inventory/web/images/
Config.IdentifierTypeComment 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 :

ValeurLes 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:… inclusVous n’exigez pas Discord
'esx'L’identifiant propre à ESX, préfixe de personnage inclusESX avec multi-personnage, pour séparer les possessions
'citizenid'Le citizen ID de QBCoreQBCore 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.


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


  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.


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