Um bot de Discord para servidores de FiveM com ESX, QBCore, Qbox, ox_core e vRP

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 bank e 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.

FrameworkResourceO que ela lê
ESX Legacy e ESX antigoes_extendedNome, emprego, nome do grade e o emprego oculto como gangue nos forks que têm um
Forks do ESX com GetPlayerFromIdClasses_extendedNome e sobrenome, emprego, nome do grade, emprego oculto
Qboxqbx_coreDados do personagem, emprego, grade, gangue
QBCoreqb-coreDados do personagem, emprego, grade, gangue
ox_coreox_coreNome do personagem, grupo ativo e o grade nele
vRP (builds vRPex)vrpIdentidade 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

  1. No painel, abra Configurações, Game Server Bridge, baixe o fivebot_bridge e crie um token de servidor. O segredo compartilhado aparece uma vez só, então copie na hora.
  2. Coloque o fivebot_bridge em resources/.
  3. Adicione as linhas abaixo ao server.cfg e 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.

Continue lendo

Seu staff já respondeu essa quarenta vezes hoje.

A instalação leva cerca de dez minutos, e não há limite de tickets.