Troubleshooting

Běžné problémy a způsoby jejich řešení.

Dvě chatovací okna / duplicitní chat

Přičína: výchozí resource chat stále běží společně s BUPA Chat. Protože BUPA Chat má provide 'chat', hlásí se oba jako chat.

Řešení: zastavte nebo odstraňte základní resource chat. V konfiguračním souboru nikde nezadávejte ensure chat – pouze ensure bupa-chat.

Resource se nespustí / UI je prázdné

Příčina: chybějící závislost. BUPA Chat závisí na ox_lib, qb-core a deklaruje dependency '/assetpacks'.

Řešení: ujistěte se, že všechny tři startují před BUPA Chat:

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

Pokud assetpacks chybí, zabalené soubory rozhraní se nepodaří načíst a chat se nikdy nezobrazí.

Nezobrazují se žádné zprávy

• Ujistěte se, že ostatní resourcy odesílají zprávy přes standardní API – chat:addMessage (event) nebo exports.chat:addMessage(...). Viz Developer API.
• U zpráv v kategoriích ověřte, zda má hráč skutečně přístup: permissions (ACE), jobs nebo gangs u dané kategorie se musí shodovat. Hráč bez přístupu tuto záložku nikdy neuvidí ani ji nemůže použít.
• Zkontrolujte maxLength u kategorie – příliš dlouhé zprávy se zkracují, nikoliv zahazují, ale neodpovídající type v vlastní integraci bude ignorován.

Návrhy se nezobrazují

• Návrhy příkazů jsou generovány z registrovaných příkazů, k jejichž použití má hráč ACE oprávnění (command.<name>). Pokud hráč nemá pro daný příkaz ACE oprávnění, nebude mu navržen.
• Návrhy se aktualizují při načtení hráče a při spuštění/zastavení resource. Pokud se nově registrovaný příkaz nezobrazí, restartujte příslušný resource nebo znovu otevřete chat.
• Pro vlastní nápovědu/parametry je odešlete explicitně pomocí chat:addSuggestion / chat:addSuggestions.

Všechno je v angličtině (nebo ve špatném jazyce)

Příčina: konvar jazykové mutace není nastaven, takže se BUPA Chat vrací k výchozímu en.

Řešení: nastavte jazyk v souboru server.cfg:

setr ox:locale "tr"
# nebo vynutit pouze pro chat:
setr bupa-chat:locale "tr"

Pamatujte, že bupa-chat:locale má přednost před ox:locale. Pro změnu za běhu použijte klientský event bupa:changeLanguage. Viz Localization.

Chybějící překlady zobrazují název klíče

t() vrací klíč (např. CATEGORY_ADMIN_LABEL), pokud v aktivním jazykovém souboru chybí překlad. Přidejte chybějící klíč do souboru locales/<code>.json nebo jej zkopírujte z en.json.

qb-core / framework nebyl detekován

Příčina: jádro frameworku se spustilo po spuštění BUPA Chat (nebo neběží, když BUPA Chat nabootuje).

Řešení: ujistěte se, že qb-core (nebo qbx_core / es_extended) startuje před BUPA Chat. Framework bridge automaticky detekuje Qbox, QB-Core a ESX; můžete jej také ručně nastavit nebo zakázat pomocí konvaru bupa-chat:framework (výchozí qb-core; nastavením na false jej spustíte bez frameworku).

Protokolování na Discord / bridge nefunguje

• Protokoly webhooku nedorazí: ověřte, zda adresy URL v souboru server/webhook.lua jsou skutečné Discord webhook URL a nikoliv zástupné hodnoty.
• Discord → chat bridge je tichý: v souboru shared/config/discord.lua nastavte active = true, vyplňte channelId a zadejte token bota + ID serveru (v config.discord nebo převzaté z config.adminChatName.discord). Zprávy odeslané botem jsou záměrně ignorovány.