Para conectar o txAdmin ao Discord, crie um aplicativo e bot Discord dedicados, convide-o para o servidor correto com apenas as permissões necessárias, copie o token do bot nas configurações do Discord do txAdmin e configure as mensagens de status e o acesso baseado em cargos como recursos separados. Mantenha o token privado: ele autentica o bot e nunca deve aparecer em capturas de tela, arquivos do cliente ou um repositório público.
Separe os quatro componentes
| Parte | Propósito | Falha típica |
|---|---|---|
| aplicativo Discord e bot | Identidade usada por txAdmin | Aplicativo errado, bot desativado ou token regenerado |
| Status do servidor | Publica ou atualiza o status em um canal escolhido | Canal errado ou permissões de visualização/envio/incorporação ausentes |
| Cargos ou lista de permissões | Mapeia a associação/cargos Discord para a regra de acesso configurada | ID incorreto do servidor ou cargo, hierarquia de cargos ou exigência de intent de membros |
| Permissões do txAdmin | Controla quem pode administrar o servidor FiveM | Suposição de que um cargo no Discord concede automaticamente permissões no txAdmin |
Não depure esses componentes como uma única funcionalidade. Primeiro confirme que o bot está online, depois que consegue acessar um canal, em seguida configure o status e só então teste a lógica opcional de cargos ou da lista de acesso permitido.
Passo 1: crie um aplicativo Discord dedicado
- Abra o Portal do Desenvolvedor do Discord e crie um novo aplicativo para este servidor.
- Adicione um bot ao aplicativo.
- Dê um nome claro ao bot para que a equipe possa distinguir o ambiente de produção do ambiente de homologação.
- Gere ou redefina o token apenas quando estiver pronto para armazená-lo com segurança.
Um token de bot é um segredo, não um ID de aplicativo ou chave pública. Se for exposto, redefina-o no Discord e atualize o txAdmin imediatamente. Armazene a substituição apenas na configuração do lado do servidor destinada ao token.
Passo 2: convide o bot com permissões mínimas
Use o fluxo de instalação OAuth2 do Discord para o aplicativo e selecione o escopo do bot exigido pela configuração atual. Comece com as menores permissões de canal que satisfaçam o recurso: visualize o canal selecionado, envie mensagens, incorpore links e leia o histórico de mensagens onde a atualização de status precisar. Evite Administrador, a menos que a integração oficial o exija explicitamente e você tenha revisado o porquê.
Restrinja o bot a um canal de status ou administração dedicado, quando prático. Após convidá-lo, confirme se ele aparece no servidor Discord pretendido. Ser listado como offline é esperado até que o txAdmin faça login com sucesso com o token.
Passo 3: configure o bot no txAdmin
Abra o txAdmin como um administrador autorizado e localize as configurações de integração do Discord em sua versão instalada. Cole o token no campo do token sem aspas ou espaços extras. Selecione o servidor e o canal Discord pretendidos usando as entradas fornecidas pelo txAdmin. Salve e, em seguida, reinicie apenas o componente ou servidor se a interface solicitar.
Se você estiver construindo o lado FiveM do zero, use o caminho de configuração do servidor FiveM primeiro. O Discord não pode corrigir um FXServer com problemas ou uma instância inacessível do txAdmin.
Configure as mensagens de status separadamente
Ative a funcionalidade de status e selecione um canal onde o bot possa publicar. Comece com uma atualização simples de teste antes de adicionar texto personalizado ou embeds. Confirme que a mensagem muda quando o servidor FiveM inicia, para ou muda a quantidade de jogadores, conforme o comportamento documentado pela sua versão do txAdmin.
Se o bot fizer login, mas nenhum status aparecer, verifique o ID do canal selecionado e as substituições de permissões específicas desse canal. Um cargo do servidor pode permitir o envio, enquanto uma permissão do canal o nega. Inspecione também a saída do console ou dos logs do txAdmin para ver a resposta da API do Discord em vez de gerar o token repetidamente.
Configure os cargos ou as regras de whitelist separadamente
O acesso baseado em cargos exige os identificadores exatos do servidor e dos cargos do Discord esperados pela integração. Ative o modo de desenvolvedor do Discord para copiar os IDs quando a configuração atual os solicitar. Nomes de cargos não são identificadores estáveis e dois cargos podem ter nomes semelhantes.
Teste com uma conta que tenha o cargo exigido e outra que não tenha. Remova e adicione novamente o cargo, reconecte e confirme quando a integração atualiza a participação. Não presuma que um cargo do Discord concede automaticamente permissões de administrador no txAdmin; o modelo de permissões do próprio txAdmin permanece um controle separado, a menos que a funcionalidade documentada faça esse mapeamento explicitamente.
Proteja o token e os limites de permissão
- Nunca cole o token em um chat do Discord, em um ticket de suporte visível para outras pessoas ou em um recurso do lado do cliente.
- Não o inclua em commits do Git nem em capturas de tela públicas.
- Limite o acesso ao aplicativo no Discord Developer Portal e às configurações do txAdmin.
- Redefina o token após uma exposição ou quando um administrador com acesso sair.
- Revise periodicamente as permissões do bot no servidor e nos canais.
Lista de verificação para solucionar problemas
| Sintoma | Verificação |
|---|---|
| O bot permanece offline | O token pertence ao bot correto, não contém espaços em branco, não foi redefinido e os logs do txAdmin mostram uma tentativa de login |
| O bot está online, mas não consegue publicar | Canal selecionado, permissões de visualizar, enviar e incorporar links, e substituições de permissões do canal |
| O status nunca é atualizado | Funcionalidade de status ativada, canal correto, estado do txAdmin/FXServer e log da integração |
| Um membro com o cargo é rejeitado | ID correto do servidor e do cargo, cargo realmente atribuído, comportamento de atualização e reconexão e qualquer intent de membros exigida |
| Um membro não autorizado é aceito | Regras alternativas de acesso, vários cargos permitidos e configuração de permissões no servidor |
| Parou de funcionar após redefinir o token | O txAdmin ainda está usando o token antigo; salve o novo e reinicie conforme necessário |
Verificação final
- O bot faz login após uma reinicialização limpa, sem erros de token.
- O status é publicado somente no canal pretendido.
- O cargo mínimo do bot permite atualizar a mensagem sem privilégios mais amplos no servidor.
- O usuário de teste autorizado passa pela regra de cargo ou whitelist.
- O usuário de teste não autorizado é rejeitado pela mesma regra.
- Nem o acesso ao Discord nem um botão oculto na interface contornam as permissões de administrador do próprio txAdmin.
Quando essas verificações passam de forma independente, a integração fica mais fácil de manter: uma identidade de bot, um segredo protegido, acesso restrito aos canais e regras explícitas para status, whitelist e administração.
Documentação de referência
Cfx.re — txAdmin · Fonte: docs.discord.com · Fonte: docs.discord.com