> For the complete documentation index, see [llms.txt](https://bsensei-script.gitbook.io/bsensei-script-documentation-officiel-fivem/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://bsensei-script.gitbook.io/bsensei-script-documentation-officiel-fivem/illegal-and-criminalite/bsensei-npc-robbery-braquage-de-citoyens-immersif/faq-and-problemes-frequents.md). # FAQ & problèmes fréquents ## ❓ FAQ & problèmes fréquents Cette page regroupe les problèmes les plus courants rencontrés avec **BSensei NPC Robbery** ainsi que les vérifications à effectuer avant de contacter le support. *** ### 🎯 L’interaction n’apparaît pas sur les PNJ Vérifie que les ressources suivantes sont bien démarrées : ``` ensure ox_lib ensure ox_target ensure BSensei_npcrobbery ``` Contrôle également que : * `ox_target` ne génère aucune erreur * le PNJ est vivant et compatible * le joueur se trouve à la bonne distance * le script est démarré après ses dépendances * aucune autre ressource ne bloque les interactions sur les PNJ Tu peux également tester la commande configurée : ``` /snatch ``` Si elle est activée dans `config.lua` : ```lua Config.Interaction.EnableCommand = true Config.Interaction.CommandName = "snatch" ``` *** ### 👮 Le script indique qu’il n’y a pas assez de policiers Vérifie le nombre minimum configuré : ```lua Config.RequiredPolice = 2 ``` Les métiers comptabilisés doivent correspondre exactement aux noms utilisés par ton serveur. Exemple : ```lua Config.Dispatch.Jobs = { "police", "sheriff" } ``` 💡 Les noms doivent correspondre aux jobs définis dans ta base de données. Pour tester temporairement sans restriction : ```lua Config.RequiredPolice = 0 ``` *** ### ⏱️ Le joueur ne peut pas recommencer un braquage Un cooldown est probablement encore actif. Vérifie cette valeur dans `config.lua` : ```lua Config.Cooldown = 90 ``` La durée est exprimée en secondes. Exemple : ``` 90 secondes = 1 minute et 30 secondes ``` Pour effectuer des tests rapides, tu peux réduire temporairement la valeur : ```lua Config.Cooldown = 10 ``` ⚠️ Pense à remettre une valeur correcte avant l’ouverture du serveur. *** ### 💰 Le joueur ne reçoit aucune récompense Vérifie que les récompenses sont activées : ```lua Config.Rewards.Money.enabled = true Config.Rewards.Items.enabled = true ``` Contrôle également : * que le braquage a réellement été réussi * que le joueur possède suffisamment de place * que le système d’inventaire sélectionné est correct * que les objets configurés existent * qu’aucune erreur n’apparaît dans la console serveur Exemple d’objet : ```lua { name = "md_goldring", label = "Bague en or", quantity = 1 } ``` Si `md_goldring` n’existe pas dans ton inventaire, remplace-le par un objet valide. *** ### 🎒 Le message « inventaire plein » apparaît Le joueur ne possède pas suffisamment de place pour recevoir l’objet. Vérifie : * le poids de l’objet * la capacité maximale de l’inventaire * la quantité configurée * la compatibilité avec ton inventaire Exemple : ```lua { name = "phone", label = "Téléphone", quantity = 1 } ``` Tu peux réduire la quantité ou remplacer l’objet par une récompense plus légère. *** ### 🚨 La police ne reçoit aucune alerte Vérifie que le dispatch est activé : ```lua Config.Dispatch.Enabled = true ``` Puis contrôle le système sélectionné : ```lua Config.Dispatch.System = "qs" ``` Pour QS-Dispatch, vérifie que la ressource démarre avant NPC Robbery : ``` ensure qs-dispatch ensure BSensei_npcrobbery ``` Contrôle également les métiers configurés : ```lua Config.Dispatch.Jobs = { "police", "sheriff" } ``` Pour tester sans dispatch externe : ```lua Config.Dispatch.System = "fallback" ``` *** ### 🔔 Les notifications ne s’affichent pas Vérifie le système sélectionné : ```lua Config.Notifications.System = "esx" ``` Valeurs disponibles : ``` esx ox_lib okokNotify qbcore custom ``` Assure-toi que la ressource correspondante est bien démarrée. Exemple avec `ox_lib` : ``` ensure ox_lib ensure BSensei_npcrobbery ``` Pour une intégration personnalisée, vérifie le fichier : ``` BSensei_npcrobbery/shared/editable.lua ``` *** ### 🎮 Le mini-jeu ne se lance pas Vérifie que `ox_lib` fonctionne correctement. Dans `server.cfg` : ``` ensure ox_lib ensure BSensei_npcrobbery ``` Contrôle également : * que le braquage a bien été autorisé * que le joueur utilise une arme compatible * que le PNJ n’est pas déjà occupé * qu’aucune erreur client n’apparaît dans la console F8 *** ### 🔫 Le joueur ne peut pas braquer un PNJ avec son arme Vérifie la configuration des armes. Si une arme est obligatoire, assure-toi que l’option correspondante est activée. Contrôle également que : * l’arme est sortie * le joueur vise correctement le PNJ * l’arme n’est pas interdite dans la configuration * le PNJ se trouve à portée *** ### 🏃 Le PNJ fuit ou attaque trop souvent Les réactions sont basées sur les probabilités configurées. Réduis les chances de fuite ou d’attaque dans `config.lua`. Exemple : ```lua Config.PedReactions = { Cooperate = 50, RunAway = 20, Defend = 15, Attack = 10, CallPolice = 5 } ``` ⚠️ Le total des probabilités doit rester cohérent. *** ### 🌍 Les textes restent dans la mauvaise langue Vérifie la langue sélectionnée : ```lua Config.Locale = "fr" ``` Assure-toi que cette langue existe dans : ``` BSensei_npcrobbery/shared/locale.lua ``` Valeurs incluses : ``` fr en ``` Après modification, redémarre la ressource : ``` restart BSensei_npcrobbery ``` *** ### ⚙️ Le framework n’est pas détecté Vérifie cette ligne : ```lua Config.Framework = "esx" ``` Pour QBCore : ```lua Config.Framework = "qbcore" ``` Assure-toi également que le framework démarre avant le script : ``` ensure es_extended ensure BSensei_npcrobbery ``` ou : ``` ensure qb-core ensure BSensei_npcrobbery ``` *** ### 📁 Erreur après avoir renommé le dossier Utilise le nom recommandé : ``` BSensei_npcrobbery ``` Évite les noms contenant : * des espaces * des accents * des parenthèses * un numéro de version * un double dossier ❌ Mauvais exemple : ``` resources/BSensei_npcrobbery/BSensei_npcrobbery ``` ✅ Bon exemple : ``` resources/[bsensei]/BSensei_npcrobbery ``` *** ### 🧠 Activer le mode debug Pour obtenir davantage d’informations dans les consoles : ```lua Config.Debug = true ``` Redémarre ensuite la ressource : ``` restart BSensei_npcrobbery ``` Une fois le problème résolu, désactive le debug : ```lua Config.Debug = false ``` *** ### 🚨 Avant de contacter le support Prépare les informations suivantes : * ton framework * ton système d’inventaire * ton système de notifications * ton dispatch * une capture de l’erreur * les logs client F8 * les logs de la console serveur * les modifications effectuées dans `config.lua` 💡 Ne transmets jamais tes clés privées, tokens Discord ou informations sensibles. *** ### 📞 Besoin d’aide supplémentaire ? Si tu as suivi toute la doc et que le problème persiste : 💬 Rejoins le support :\ 👉 *** © **BSensei Scripts** · Tous droits réservés. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://bsensei-script.gitbook.io/bsensei-script-documentation-officiel-fivem/illegal-and-criminalite/bsensei-npc-robbery-braquage-de-citoyens-immersif/faq-and-problemes-frequents.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.