Troubleshooting

Veelvoorkomende problemen en hoe je ze kunt oplossen.

Twee chatboxen / dubbele chat

Cause: de standaard chat resource draait nog steeds tegelijk met BUPA Chat. Omdat BUPA Chat provide 'chat' gebruikt, registreren beide zich als chat.

Fix: stop of verwijder de standaard chat resource. Voer ensure chat nergens uit in je config — alleen ensure bupa-chat.

Resource wil niet starten / UI is leeg

Cause: een ontbrekende afhankelijkheid. BUPA Chat is afhankelijk van ox_lib, qb-core en declareert dependency '/assetpacks'.

Fix: zorg ervoor dat alle drie starten before BUPA Chat:

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

Als assetpacks ontbreekt, mislukt het laden van de ingepakte UI-assets en verschijnt de chat nooit.

Er worden geen berichten weergegeven

• Zorg ervoor dat andere resources berichten verzenden via de standaard API — chat:addMessage (event) of exports.chat:addMessage(...). Zie Developer API.
• Voor category berichten, bevestig dat de speler daadwerkelijk toegang heeft: permissions (ACE), jobs of gangs op de categorie moeten overeenkomen. Een speler zonder toegang ziet of gebruikt dat tabblad nooit.
• Controleer maxLength op de categorie — te lange berichten worden ingekort, niet genegeerd, maar een niet-overeenkomende type in een aangepaste integratie wordt genegeerd.

Suggesties verschijnen niet

• Commandsuggesties worden opgebouwd uit geregistreerde commands die de speler ACE-allowed is om te gebruiken (command.<name>). Als een command niet ACE-toegestaan is voor die speler, wordt het niet voorgesteld.
• Suggesties worden vernieuwd bij het laden van de speler en wanneer resources starten/stoppen. Als een nieuw geregistreerd command niet verschijnt, herstart dan de leverende resource of heropen de chat.
• Voor aangepaste helptekst/params, push deze expliciet met chat:addSuggestion / chat:addSuggestions.

Alles is in het Engels (of de verkeerde taal)

Cause: de locale convar is niet ingesteld, dus BUPA Chat valt terug op en.

Fix: stel de taal in server.cfg:

setr ox:locale "tr"
# of forceer alleen chat:
setr bupa-chat:locale "tr"

Vergeet niet dat bupa-chat:locale ox:locale overschrijft. Gebruik voor een live wijziging het client event bupa:changeLanguage. Zie Localization.

Ontbrekende vertalingen tonen de sleutelnaam

t() retourneert de key (bijv. CATEGORY_ADMIN_LABEL) wanneer een vertaling ontbreekt in het actieve taalbestand. Voeg de ontbrekende sleutel toe aan die locales/<code>.json, of kopieer deze uit en.json.

qb-core / framework niet gedetecteerd

Cause: de framework core startte na (of draait niet wanneer) BUPA Chat opstart.

Fix: zorg ervoor dat qb-core (of qbx_core / es_extended) start vóór BUPA Chat. De framework bridge detecteert automatisch Qbox, QB-Core en ESX; je kunt dit ook vastzetten of uitschakelen met de convar bupa-chat:framework (standaard qb-core; stel in op false om zonder framework te draaien).

Discord logging / bridge werkt niet

• Webhook logs komen niet aan: bevestig dat de URL's in server/webhook.lua echte Discord webhook URL's zijn en niet de placeholderwaarden.
• Discord → chat bridge stil: zet in shared/config/discord.lua active = true, vul channelId in, en geef een bot token + guild ID op (in config.discord of hergebruikt van config.adminChatName.discord). Door bots geschreven berichten worden opzettelijk genegeerd.