Um bot de Discord para servidores de FiveM com ESX, QBCore, Qbox, ox_core e vRP
Por Termi5 min de leitura
O FiveBot é um bot de Discord para tickets, moderação e respostas de IA a partir das suas próprias regras. Ele também vem com um resource de FiveM, o fivebot_bridge, que liga o seu servidor de jogo ao mesmo painel. O lado do Discord funciona sem ele. Com ele, tickets, denúncias e bans sabem quem é o jogador na cidade.
O que funciona sem o servidor de jogo
Tudo o que roda no Discord funciona em qualquer servidor, de FiveM ou não. Você tem painéis de ticket com atribuição livre e transcrições permanentes, anti-spam, anti-raid e anti-nuke, candidaturas em formulários web, cargos por reação e comandos personalizados em todos os planos. A partir do Starter, os tickets também ganham respostas de IA citadas das suas regras, tradução nos dois sentidos e o Hollo, uma bolha de chat para o seu site.
Muitas comunidades de FiveM começam por aí e instalam a bridge quando o lado do Discord já está ajustado.
O que a bridge acrescenta
A bridge funciona em todos os planos. É um resource só, sem dependências obrigatórias, e traz as partes que precisam do jogo. A ficha do jogador precisa do Starter, e o desenvolvedor de IA e os NPCs com IA precisam do Pro.
- Uma contagem de jogadores ao vivo num canal do Discord, enviada a cada dois minutos.
- Bans, advertências, kicks e bans removidos do txAdmin, cada um com o admin que aplicou e o motivo. Nove anticheats, entre eles WaveShield, Fiveguard e ElectronAC, também enviam os deles, cada ban com o que o servidor viu o jogador fazer antes. Qualquer outro menu de admin ou anticheat pode reportar por um export. Como as ações do txAdmin chegam ao FiveBot.
- Denúncias no jogo. Um jogador digita
/report 12 shot me at the banke a sua equipe recebe o mesmo card de uma denúncia feita no Discord, com os dois personagens e a distância entre eles. Mais sobre denúncias no jogo. - Pagamentos da loja. Quando um jogador diz que uma compra nunca chegou, o FiveBot pergunta à bridge, e a bridge pergunta à loja. O Tebex funciona sozinho, o Skalp se conecta por conta própria e qualquer outra loja pode se conectar com um export. Como lidar com "paguei e não recebi nada".
- Erros de script do console do servidor, reunidos no painel sem senhas, tokens, endereços IP e e-mails. Você recebe um e-mail quando eles disparam e um resumo curto uma vez por dia. Alertas de erro de script.
- Uma ficha do jogador no painel com dinheiro, itens, emprego e carros, e mudanças como dar dinheiro ou definir um emprego com um botão. Como ver um jogador.
- Mudanças de config e de script a partir de um pedido simples, mostradas antes de salvar e revertidas se o script falhar. O desenvolvedor de IA.
- Todo comando que a sua equipe executa no servidor de jogo, por admin. O registro de comandos de admin.
- NPCs com IA que ficam na sua cidade e conversam com os jogadores. Como eles funcionam.
Frameworks que ela lê
Ao iniciar, a bridge procura um framework e lê o nome, o emprego, o grade e a gangue do personagem. É assim que um NPC cumprimenta um policial pela patente e que um card de denúncia dá o nome dos personagens envolvidos.
| Framework | Resource | O que ela lê |
|---|---|---|
| ESX Legacy e ESX antigo | es_extended | Nome, emprego, nome do grade e o emprego oculto como gangue nos forks que têm um |
Forks do ESX com GetPlayerFromIdClass | es_extended | Nome e sobrenome, emprego, nome do grade, emprego oculto |
| Qbox | qbx_core | Dados do personagem, emprego, grade, gangue |
| QBCore | qb-core | Dados do personagem, emprego, grade, gangue |
| ox_core | ox_core | Nome do personagem, grupo ativo e o grade nele |
| vRP (builds vRPex) | vrp | Identidade e o grupo do tipo job |
Sem framework, a bridge roda só com os identificadores do jogador, e essa é uma configuração com suporte. Um framework que inicia depois da bridge é reconhecido quando inicia. Para forçar um, defina fivebot_framework como esx, qbcore, qbox, ox, vrp ou none. Um core renomeado é encontrado pelos exports dele, e o mesmo vale para o inventário e o script médico. Frameworks e inventários suportados.
Como instalar
- No painel, abra Configurações, Game Server Bridge, baixe o
fivebot_bridgee crie um token de servidor. O segredo compartilhado aparece uma vez só, então copie na hora. - Coloque o
fivebot_bridgeemresources/. - Adicione as linhas abaixo ao
server.cfge reinicie. Se faltar uma linha, o console do servidor diz qual.
set fivebot_api_url "https://api.fivebot.ai"
set fivebot_server_token "srv_..."
set fivebot_shared_secret "..."
ensure fivebot_bridge
O token e o segredo ficam no server.cfg, fora da pasta do resource. Resources são copiados, zipados e compartilhados, e um token dentro da pasta iria junto em cada cópia.
Os personagens com IA são criados pelo servidor e precisam do OneSync, que o txAdmin liga por padrão. Todo o resto funciona sem ele. ox_lib, oxmysql e um framework são todos opcionais.
O que ela não toca
O FiveM informa um identificador ip: junto com os outros, e a bridge descarta esse identificador antes de guardar ou enviar qualquer coisa. Ela também não mantém lista de bans no seu servidor: os bans são conferidos no FiveBot quando importam.
Os arquivos de lógica da bridge são ofuscados. Dois arquivos continuam legíveis e são seus para editar: o config.lua para os tempos e o client/chat.lua para a forma como as falas do FiveBot chegam ao jogador. Uma atualização substitui todo o resto, então mantenha as suas mudanças nesses dois.
Quanto tráfego ela gera
Entradas e saídas vão em lotes a cada dois segundos, nunca uma requisição por evento. A contagem de jogadores vai a cada dois minutos. A bridge procura ações do painel a cada três a quatro segundos e meio. Quando a API está fora do ar, cada rota com falha entra no log uma vez, e mais uma vez quando volta, então um token errado não inunda o console.
Perguntas frequentes
Preciso do Pro para o bot de Discord?
Não. O Entry e o Starter rodam tickets, moderação, segurança e, no Starter, respostas de IA e o Hollo. A bridge funciona em todos os planos e lê os dados de personagem do ESX, QBCore, Qbox, ox_core ou vRP. Os NPCs com IA e o Bodycam começam no Pro. Os preços atuais estão em fivebot.ai/pricing.
Funciona com o txAdmin sem configurar nada?
Sim. A bridge escuta os próprios eventos do txAdmin, então bans, advertências e kicks chegam sem nenhuma configuração no txAdmin.
Posso rodar junto com os meus outros bots?
Sim. O FiveBot não precisa ser o único bot do servidor, então você pode manter o seu bot de tickets antigo enquanto compara.
O FiveBot tem ligação com a Cfx.re?
Não. O FiveBot não tem ligação com a Cfx.re, a Rockstar Games nem a Take-Two Interactive.