Troubleshooting

Problemas comuns e como resolvê-los.

Duas caixas de chat / chat duplicado

Cause: o recurso chat padrão ainda está em execução junto com o BUPA Chat. Como o BUPA Chat usa provide 'chat', ambos se registram como chat.

Fix: pare ou remova o recurso chat padrão. Não use ensure chat em nenhuma parte da sua configuração — apenas ensure bupa-chat.

O recurso não inicia / a UI está em branco

Cause: falta de uma dependência. O BUPA Chat depende de ox_lib, qb-core e declara dependency '/assetpacks'.

Fix: certifique-se de que todos os três iniciem antes do BUPA Chat:

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

Se assetpacks estiver faltando, os assets empacotados da UI falham ao carregar e o chat nunca aparece.

Nenhuma mensagem aparecendo

• Certifique-se de que outros recursos enviem mensagens através da API padrão — chat:addMessage (evento) ou exports.chat:addMessage(...). Consulte Developer API.
• Para mensagens de category, confirme se o jogador realmente tem acesso: permissions (ACE), jobs ou gangs na categoria devem corresponder. Um jogador sem acesso nunca vê ou usa essa aba.
• Verifique maxLength na categoria — mensagens excessivamente longas são truncadas, não descartadas, mas um type incompatível em uma integração personalizada será ignorado.

Sugestões não aparecem

• As sugestões de comandos são construídas a partir de comandos registrados que o jogador tem permissão ACE para usar (command.<name>). Se um comando não tiver permissão ACE para esse jogador, ele não será sugerido.
• As sugestões são atualizadas ao carregar o jogador e quando os recursos iniciam/param. Se um comando recém-registrado não aparecer, reinicie o recurso provedor ou reabra o chat.
• Para texto de ajuda/parâmetros personalizados, envie-os explicitamente com chat:addSuggestion / chat:addSuggestions.

Tudo está em inglês (ou no idioma errado)

Cause: a convar de localização não está definida, então o BUPA Chat recorre ao en.

Fix: defina o idioma no server.cfg:

setr ox:locale "tr"
# ou force apenas o chat:
setr bupa-chat:locale "tr"

Lembre-se de que bupa-chat:locale substitui ox:locale. Para uma alteração em tempo de execução, use o evento de cliente bupa:changeLanguage. Consulte Localization.

Traduções ausentes mostram o nome da chave

t() retorna a key (por exemplo, CATEGORY_ADMIN_LABEL) quando falta uma tradução no arquivo de idioma ativo. Adicione a chave ausente em locales/<code>.json ou copie-a de en.json.

qb-core / framework não detectado

Cause: o núcleo do framework iniciou depois (ou não está rodando quando) o BUPA Chat inicializa.

Fix: certifique-se de que qb-core (ou qbx_core / es_extended) inicie antes do BUPA Chat. A ponte do framework autodetecta Qbox, QB-Core e ESX; você também pode fixá-la ou desativá-la com a convar bupa-chat:framework (padrão qb-core; defina como false para rodar sem framework).

Logs do Discord / ponte não funcionando

• Logs de webhook não chegam: confirme se as URLs em server/webhook.lua são URLs reais de webhook do Discord e não os valores de espaço reservado.
• Ponte Discord → chat silenciosa: em shared/config/discord.lua, defina active = true, preencha o channelId e forneça um token de bot + ID da guild (em config.discord ou reutilizado de config.adminChatName.discord). Mensagens autoriazinadas por bot são ignoradas intencionalmente.