BUPA Chat

BUPA Chat é uma substituição premium e direta para o chat padrão do FiveM. Ele traz uma interface em React totalmente customizável e substitui o recurso padrão chat, permitindo que qualquer script que já se comunique com o chat do jogo continue funcionando — sem necessidade de migração.

Em vez de uma única caixa de entrada, o BUPA Chat oferece aos jogadores uma entrada com abas contendo categorias de chat (Comandos, OOC, admin, canais de emprego/facção, mensagens privadas), um seletor de emojis, sugestões de comandos em tempo real, emotes nos estilos /me e /do exibidos acima da cabeça do jogador, emblemas de ID / nome do jogador opcionais, registro no Discord e um idioma por jogador que pode ser alterado em tempo de execução.

Key features

• Categorias / abas de chat — uma aba de command integrada, além de categorias totalmente configuráveis: OOC global, OOC local (proximidade), admin, canais de polícia/EMS, canais de facção e qualquer categoria personalizada que você definir. Cada categoria possui suas próprias cores, tags, permissões e regras de mensagem.
• Mensagens privadas — /pm (e /dm) com estilo separado para o remetente e o destinatário.
• Emotes — /me, /do, /dice e /rps prontos para uso, exibidos como texto acima da cabeça do ped e opcionalmente espelhados no chat. Adicione seus próprios emotes com animações, limites de distância e parâmetros personalizados.
• Seletor de emojis — um painel de emojis customizável e categorizado (smileys, gestos, símbolos, objetos) com shortcodes pesquisáveis.
• Sugestões de comandos — preenchidas automaticamente a partir de comandos registrados aos quais o jogador tem acesso ACE, além de qualquer coisa que você envie através da API padrão chat:addSuggestion(s).
• Emblemas de identidade do jogador — nome opcional por categoria, ID do servidor, emprego (rótulo/cargo) e tags de cargo do Discord, com ocultação de nome sensível a máscaras e exibição de ID de proximidade acima das cabeças.
• Integração com o Discord — registro em webhook de mensagens de chat/emote/PM, e uma ponte opcional do Discord para o canal do jogo que repete as mensagens do Discord no chat.
• Multi-idioma — traduções via locales do ox_lib, selecionáveis globalmente, por recurso ou em tempo real por sessão.
• UI em React customizável — modos de visibilidade (mostrar quando ativo / mostrar sempre / ocultar), sons de digitação, clique fora para fechar e teclas de abertura/visibilidade configuráveis.

Framework

O BUPA Chat foi desenvolvido para o QB-Core e está listado como uma dependência do qb-core. A ponte de framework compartilhada também detecta o Qbox (qbx_core) e o ESX (es_extended) automaticamente em tempo de execução, e o framework pode ser forçado ou desativado através da convar bupa-chat:framework.

O recurso fornece o recurso padrão chat (provide 'chat'), sendo uma substituição completa para o chat padrão do FiveM em vez de um complemento.

Dependencies

Dependency	Purpose
ox_lib	Locales, keybinds, notificações, callbacks e auxiliares de UI. Carregado como @ox_lib/init.lua e via ox_lib 'locale'.
qb-core	Núcleo do framework (dados do jogador, empregos, facções). Listado como uma dependência rígida.
assetpacks	Declarado com dependency '/assetpacks' — necessário para os assets de UI empacotados.