Dépannage

Les problèmes que les utilisateurs rencontrent réellement, à peu près dans l’ordre où ils se présentent.

Une modification d’un fichier n’a rien changé

restart ne relit pas le fxmanifest.lua. Si vous avez ajouté un fichier — une nouvelle langue, par exemple — tapez d’abord refresh dans la console du serveur, puis restart mic_shopcreator.

Erreurs concernant `es_extended` ou `qb-core` au démarrage

Config.Framework n’est pas détecté automatiquement. Définissez 'esx' ou 'qbcore' selon votre serveur, et démarrez mic_shopcreator après votre framework dans server.cfg.

Sur QBox, la valeur est 'qbcore' — QBox gère les ressources QBCore via sa compatibilité — et qbx_core doit démarrer avant mic_shopcreator.

/shopcreator indique que je n’ai pas la permission

L’ACE est mic_shop.open — et non mic_shopcreator.open. Vérifiez l’orthographe dans votre ligne add_ace, et assurez-vous qu’elle utilise un identifiant avec lequel vous vous connectez réellement, ou un groupe auquel vous appartenez vraiment.

Tout affiche « Translation not found »

Config.Locale désigne un fichier absent de locales/, ou non déclaré dans shared_scripts dans fxmanifest.lua. La console affiche Locale file not found for … lorsque cela se produit.

Le vendeur n’est pas là

Vous êtes trop loin. Les vendeurs n’existent qu’à portée de Config.PedSpawnDistance (20 mètres par défaut).
L’emplacement a été braqué. Un emplacement braqué ferme pendant son temps de recharge : le vendeur et le blip disparaissent pour tout le monde jusqu’à la fin du cooldown. Voir ci-dessous.
Config.SpawnNPC est désactivé. Dans ce cas, aucun vendeur n’apparaît par conception, seul un marqueur ou une sphère target marque la zone.
Le modèle est invalide. Si le modèle d’un lieu ne charge pas, il est remplacé par Config.DefaultPed, et la console indique Using default.. Si le modèle par défaut ne charge pas non plus, vous obtenez CRITICAL: Could not load default ped model et aucun vendeur — mettez un modèle valide dans Config.DefaultPed.

Je vois le vendeur mais ne peux pas ouvrir la boutique

Config.Interaction ne correspond pas à ce que vous utilisez. Il est livré sur 'ox_target'. Définissez 'qb-target' pour qb-target, ou 'default' pour vous approcher et appuyer sur E à portée de Config.RadiusInteract.

Sur QBCore avec 'default', l’invite n’apparaît pas — ShowHelpNotification dans bridge/client.lua est vide pour QBCore. La touche E fonctionne toujours ; complétez cette fonction avec votre appel de texte d’aide pour afficher l’invite.

« This shop is currently on cooldown » / une boutique braquée reste fermée des heures

Un emplacement braqué reste fermé pendant le Cooldown (minutes) de la boutique. Si aucun temps de recharge n’est renseigné sur une boutique, la valeur de secours est Config.RobberyCooldown — également lue en minutes, de sorte que les 300 par défaut correspondent à cinq heures. Définissez un temps de recharge sur chaque boutique braquable dans le panneau, ou réduisez la valeur de secours.

Les images de produits sont manquantes

La fenêtre de boutique recherche <nom_item>.png dans chaque dossier de Config.InventoryImagePath, dans l’ordre. Elle est configurée par défaut sur le dossier d’ox_inventory. Sur un autre inventaire, indiquez le dossier d’images de celui-ci sous forme de chemin nui://. Si le nom de l’item et le nom du fichier image diffèrent, l’image ne s’affichera pas.

L’achat avec de l’argent sale échoue sur QBCore

L’argent sale est débité d’un compte nommé black_money. QBCore ne possède pas ce compte par défaut : utilisez plutôt Cash, Bank ou All (Cash + Bank) pour les produits sur QBCore — ou créez ce compte et adaptez GetAccount dans bridge/server.lua à la gestion de l’argent sale de votre serveur.

Un propriétaire ouvre la boutique sans voir le bouton d’engrenage

La liste des propriétaires doit contenir le type d’identifiant spécifié par Config.IdentifierType :

`Config.IdentifierType`	Ce qu’il faut saisir pour le propriétaire
`'discord'`	Le numéro d’identifiant Discord uniquement, sans `discord:`
`'license'`	La licence complète, avec le préfixe `license:`
`'esx'`	L’identifiant ESX stocké dans `users`, avec le préfixe `char1:` éventuel
`'citizenid'`	Le citizen ID de QBCore

Si vous avez modifié Config.IdentifierType après avoir ajouté des propriétaires, réajoutez-les.

Impossible d’embaucher des joueurs

Avec 'discord', le joueur doit obligatoirement avoir Discord associé ; sinon, il lui est demandé de le lier.
Il doit se trouver à moins de 10 mètres du propriétaire lorsque celui-ci ouvre la liste.
Il doit appuyer sur Y à l’invite. Sur QBCore, la demande s’affiche via ShowHelpNotification dans bridge/client.lua, qui est vide pour QBCore — complétez-la ou prévenez le joueur d’appuyer sur Y.

Le braquage ne démarre pas

Le braquage doit être activé sur cette boutique, et le joueur doit viser le vendeur avec une arme — pas à mains nues — à moins de 5 mètres. Un emplacement déjà en cours de braquage ou en période de cooldown refusera l’action.

Les logs Discord n’arrivent jamais

Les Webhooks doivent être activés sur cette boutique, avec une URL de webhook Discord valide.
Config.Screenshot est actif mais screenshot-basic n’est pas lancé. Le log est transmis avec la capture d’écran : sans cette ressource, rien ne part. Démarrez screenshot-basic avant cette ressource, ou passez Config.Screenshot = false.

La police ne reçoit aucune alerte

Config.PoliceAlert = "default" avertit les joueurs dont le métier figure dans Config.RobberyNotifyJobs, par nom de job. Avec "custom", rien n’est envoyé tant que vous n’écrivez pas votre propre appel de dispatch dans TriggerPoliceAlert au sein de bridge/server.lua — livré vide par défaut.