mri_Qchat - Manual Funcional

Chat moderno e otimizado para Qbox Framework com interface React, tabs de canais, emoji picker, draggable window e integração com Discord webhook.

O que o recurso faz

O mri_Qchat substitui o chat padrão do FiveM por uma interface moderna baseada em React, organizando mensagens em 6 canais com tabs (GLOBAL, LOCAL, OOC, RP, STAFF, ANÚNCIOS), com janela arrastável, emoji picker integrado, autocomplete de comandos, settings persistidos e envio de mensagens para Discord via webhook.

Funcionalidades principais

• 6 canais com tabs: GLOBAL, LOCAL, OOC, RP, STAFF, ANÚNCIOS
• Janela arrastável: Reposicione o chat via drag and drop com constraints de borda
• Emoji picker: Integrado com emoji-picker-react (tema dark)
• Autocomplete de comandos: Tab-completion para comandos registrados
• Settings persistidos: Modo colapsado, timestamps, fade time (localStorage)
• Tema dinâmico: Sincroniza com cores do ox_lib via convars
• Discord webhook: Todas as mensagens enviadas como embeds
• Evento customizável: Outros recursos podem ouvir mensagens via evento
• Cores por canal: Cada canal com cor única configurável

Como funciona

1. Jogador carrega e NUI React inicializa com canais e settings salvos
2. Mensagens são enviadas via comandos específicos para cada canal
3. Servidor processa mensagem, envia para destinatários conforme canal
4. Mensagem é exibida via NUI message ON_MESSAGE
5. Se configurado, mensagem é enviada ao Discord via webhook como embed

Configurações disponíveis (shared/config.lua)

Opções gerais

Comandos configuráveis

Cores dos canais

Convars

Exemplo no server.cfg:

set chat:uiColor "#ff5500"
set chat:globalColor "blue.6"
set ox:primaryColor "green"
set ox:primaryShade 7

Canais de Chat

Chat padrão (sem comando): Roteado para chat local por proximidade.

Settings da UI

Eventos

Custom Event (configurável)

Outros recursos podem ouvir mensagens de chat:

AddEventHandler('mri_Qchat:server:onMessage', function(data)
    -- data: { source, author, message, channel, timestamp }
end)

NUI Messages (Server → Client)

NUI Callbacks

Integração com outros recursos MRI

Obrigatórias

• qbx_core — Nomes de personagens, permissões staff

Opcionais

• ox_lib — Sincronização de tema via convars

Evento customizado

Outros recursos podem consumir mensagens via mri_Qchat:server:onMessage:

AddEventHandler('mri_Qchat:server:onMessage', function(data)
    local src = data.source
    local author = data.author
    local message = data.message
    local channel = data.channel
    local timestamp = data.timestamp
    -- processar mensagem
end)

Exemplos práticos

Enviar mensagem via evento server

TriggerClientEvent('mri_Qchat:client:ON_MESSAGE', -1, {
    channel = 'ANÚNCIOS',
    author = 'Sistema',
    message = 'Bem-vindos ao servidor!',
    timestamp = os.time()
})

Escutar mensagens para filtragem/moderação

AddEventHandler('mri_Qchat:server:onMessage', function(data)
    if string.find(string.lower(data.message), "palavrao") then
        -- punir jogador
        DropPlayer(data.source, "Linguagem inapropriada")
    end
end)

Configurar webhook Discord

Config.DiscordWebhook = "https://discord.com/api/webhooks/..."

Solução de problemas

• Chat não aparece: Verifique se o recurso iniciou e NUI carregou (callback loaded)
• Tema não sincroniza: Confirme Config.SyncWithOx = true e convars do ox_lib definidas
• Discord webhook não envia: Verifique se a URL está correta e o Discord aceita a conexão
• Janela não arrasta: Constraints de borda impedem sair da tela
• Comandos não completam: Suggestions atualizados no chat:init e resource start
• Settings não persistem: Salvos em localStorage do navegador do jogador
• Chat padrão não funciona: Sem comando, envia para canal LOCAL por proximidade (20m)