Troubleshooting

Problèmes courants et comment les résoudre.

Deux boîtes de chat / chat en double

Cause : la ressource chat par défaut est toujours active en même temps que BUPA Chat. Comme BUPA Chat utilise provide 'chat', les deux s'enregistrent en tant que chat.

Correction : arrêtez ou supprimez la ressource chat de base. Ne faites pas ensure chat dans votre configuration — utilisez uniquement ensure bupa-chat.

La ressource ne démarre pas / L'UI est vide

Cause : une dépendance manquante. BUPA Chat dépend de ox_lib, qb-core et déclare dependency '/assetpacks'.

Correction : assurez-vous que ces trois éléments démarrent avant BUPA Chat :

ensure ox_lib
ensure qb-core
ensure assetpacks
ensure bupa-chat

Si assetpacks est manquant, les assets de l'UI empaquetés ne se chargent pas et le chat n'apparaît jamais.

Aucun message ne s'affiche

• Assurez-vous que les autres ressources envoient des messages via l'API standard — chat:addMessage (événement) ou exports.chat:addMessage(...). Voir Developer API.
• Pour les messages par catégorie, vérifiez que le joueur y a réellement accès : permissions (ACE), jobs ou gangs sur la catégorie doivent correspondre. Un joueur sans accès ne verra ou n'utilisera jamais cet onglet.
• Vérifiez maxLength sur la catégorie — les messages trop longs sont tronqués, et non supprimés, mais un type non correspondant dans une intégration personnalisée sera ignoré.

Les suggestions n'apparaissent pas

• Les suggestions de commandes sont générées à partir des commandes enregistrées que le joueur est autorisé à utiliser via ACE (command.<name>). Si une commande n'est pas permise par ACE pour ce joueur, elle ne sera pas suggérée.
• Les suggestions se rafraîchissent au chargement du joueur et lorsque les ressources démarrent/s'arrêtent. Si une commande nouvellement enregistrée n'apparaît pas, redémarrez la ressource correspondante ou réouvrez le chat.
• Pour du texte d'aide ou des paramètres personnalisés, poussez-les explicitement avec chat:addSuggestion / chat:addSuggestions.

Tout est en anglais (ou dans la mauvaise langue)

Cause : la convar de langue n'est pas définie, donc BUPA Chat utilise en par défaut.

Correction : définissez la langue dans server.cfg :

setr ox:locale "tr"
# ou forcez uniquement pour le chat :
setr bupa-chat:locale "tr"

N'oubliez pas que bupa-chat:locale remplace ox:locale. Pour un changement en direct, utilisez l'événement client bupa:changeLanguage. Voir Localization.

Les traductions manquantes affichent le nom de la clé

t() renvoie la clé (ex. CATEGORY_ADMIN_LABEL) lorsqu'une traduction est manquante dans le fichier de langue actif. Ajoutez la clé manquante dans ce locales/<code>.json, ou copiez-la depuis en.json.

qb-core / framework non détecté

Cause : le cœur du framework a démarré après (ou ne tourne pas lorsque) BUPA Chat se lance.

Fix : assurez-vous que qb-core (ou qbx_core / es_extended) démarre avant BUPA Chat. Le bridge du framework détecte automatiquement Qbox, QB-Core et ESX ; vous pouvez également le fixer ou le désactiver avec la convar bupa-chat:framework (par défaut qb-core ; définissez sur false pour l'exécuter sans framework).

Les logs Discord / le bridge ne fonctionnent pas

• Les logs de webhook n'arrivent pas : confirmez que les URLs dans server/webhook.lua sont de vraies URLs de webhook Discord et non les valeurs par défaut.
• Le bridge Discord → chat est silencieux : dans shared/config/discord.lua, définissez active = true, remplissez channelId, et fournissez un token de bot + ID de guilde (dans config.discord ou récupéré depuis config.adminChatName.discord). Les messages rédigés par un bot sont intentionnellement ignorés.