Troubleshooting

Problemi comuni e come risolverli.

Two chat boxes / duplicate chat

Cause: la risorsa chat predefinita è ancora in esecuzione insieme a BUPA Chat. Poiché BUPA Chat fa provide 'chat', entrambe si registrano come chat.

Fix: ferma o rimuovi la risorsa chat stock. Non fare ensure chat da nessuna parte nella tua configurazione — usa solo ensure bupa-chat.

Resource won't start / UI is blank

Cause: una dipendenza mancante. BUPA Chat dipende da ox_lib, qb-core e dichiara dependency '/assetpacks'.

Fix: assicurati che tutte e tre si avviino prima di BUPA Chat:

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

Se assetpacks manca, gli asset della UI pacchettizzati non riescono a caricarsi e la chat non appare mai.

No messages showing

• Assicurati che altre risorse inviino messaggi tramite l'API standard — chat:addMessage (evento) o exports.chat:addMessage(...). Vedi Developer API.
• Per i messaggi di category, conferma che il giocatore abbia effettivamente accesso: permissions (ACE), jobs o gangs sulla categoria devono corrispondere. Un giocatore senza accesso non vede né usa mai quella tab.
• Controlla maxLength sulla categoria — i messaggi eccessivamente lunghi vengono troncati, non scartati, ma un type non corrispondente in un'integrazione personalizzata verrà ignorato.

Suggestions not appearing

• I suggerimenti dei comandi sono costituiti dai comandi registrati che il giocatore è autorizzato tramite ACE a usare (command.<name>). Se un comando non è consentito via ACE per quel giocatore, non verrà suggerito.
• I suggerimenti si aggiornano al caricamento del giocatore e quando le risorse si avviano/fermano. Se un comando appena registrato non appare, riavvia la risorsa che lo fornisce o riapri la chat.
• Per testi di aiuto/parametri personalizzati, inviali esplicitamente con chat:addSuggestion / chat:addSuggestions.

Everything is in English (or the wrong language)

Cause: la convar della lingua non è impostata, quindi BUPA Chat ripiega su en.

Fix: imposta la lingua in server.cfg:

setr ox:locale "tr"
# or force only chat:
setr bupa-chat:locale "tr"

Ricorda che bupa-chat:locale sovrascrive ox:locale. Per un cambio in tempo reale usa l'evento client bupa:changeLanguage. Vedi Localization.

Missing translations show the key name

t() restituisce la key (es. CATEGORY_ADMIN_LABEL) quando manca una traduzione dal file della lingua attiva. Aggiungi la chiave mancante in quel locales/<code>.json, o copiala da en.json.

qb-core / framework not detected

Cause: il core del framework si è avviato dopo (o non è in esecuzione quando) BUPA Chat si avvia.

Fix: assicurati che qb-core (o qbx_core / es_extended) si avvii prima di BUPA Chat. Il bridge del framework rileva automaticamente Qbox, QB-Core ed ESX; puoi anche bloccarlo o disabilitarlo con la convar bupa-chat:framework (predefinita qb-core; impostala su false per eseguirlo senza framework).

Discord logging / bridge not working

• Webhook logs not arriving: conferma che gli URL in server/webhook.lua siano URL webhook Discord reali e non i valori segnaposto.
• Discord → chat bridge silent: in shared/config/discord.lua, imposta active = true, compila channelId e fornisci un token + ID gilda del bot (in config.discord o riutilizzato da config.adminChatName.discord). I messaggi scritti da bot vengono intenzionalmente ignorati.