O que a integração Discord do txAdmin faz
O txAdmin está incluído nas compilações atuais do FXServer e sua integração nativa Discord pode manter um status embed e suportar whitelisting de membro ou papel Discord. Crie um aplicativo Discord dedicado, conceda apenas as permissões que o canal de status precisa, armazene o token do bot apenas no txAdmin e teste a integração em um guild ou canal não de produção primeiro.
- Nunca cole o token do bot no chat, screenshots, tickets ou
servidor.cfg. - Não conceda a permissão de Administrador Discord quando as permissões de nível de canal Ver, Enviar, Embed e Histórico forem suficientes.
- Se os rótulos do portal forem diferentes deste guia, siga o atual Instalação página e o atual Configurações → Discord campos.
- Gire o token imediatamente se ele for exposto, depois atualize o txAdmin e reteste o status embed.
Meta: Habilite a integração nativa do Discord do txAdmin para incorporações de status e (opcional) lista de permissões apoiada pelo Discord.
Funciona com qualquer construção FXServer que inclua administrador do tx. Não é necessária hospedagem de terceiros nem estrutura de bot.
Pré-requisitos
- Um servidor FiveM em execução com administrador do tx ativado (Configurações → Global mostra que o painel está ativo).
- Permissão para criar um aplicativo Discord em seu Portal do Desenvolvedor Discord.
- Modo de desenvolvedor habilitado nas configurações de usuário do Discord (para que você possa copiar IDs de Servidor/Canal/Função).
- O ID da guilda (servidor) e (opcionalmente) um ID do canal onde o bot tem permissão para postar.
Etapa 1 — Crie o aplicativo e o bot do Discord
- Abra o Portal do Desenvolvedor Discord e clique Novo aplicativo.
- Dentro do aplicativo, acesse Robô → Token de redefinição e copie o Token de bot. Mantenha isso em segredo.
- No mesmo Robô página, habilitar INTENÇÃO DOS MEMBROS DO SERVIDOR. Salvar.
Dica: Você não precisa das intenções Presença ou Conteúdo da Mensagem para os recursos integrados do txAdmin.
Etapa 2 — Convide o bot para o seu servidor do Discord
- No portal de desenvolvedores Discord, abra Instalação. Configure um link de instalação de servidor lá; layouts mais antigos do portal podem mostrar o equivalente Gerador de URL OAuth2.
- Escopos: selecionar robô e aplicações.comandos (comandos de barra).
- Permissões: selecionar Ver canais, Enviar mensagens, Incorporar links, Ler histórico de mensagens.
- Use o link de instalação para adicionar o app a um servidor de teste Discord primeiro, confirme os escopos e permissões solicitados e só então instale-o no guild de produção.
Mantenha as permissões mínimas. O bot só precisa ler/publicar e incorporar.
Etapa 3 — Conecte o bot ao txAdmin
- Abra seu administrador do tx painel web.
- Vá para Configurações → Discord.
- Alternar Habilitar Discord Bot.
- Preencha os campos:
- Token de bot: cole o token do Passo 1.
- ID da guilda: seu ID do servidor Discord (clique com o botão direito no ícone do servidor → Copiar ID).
- ID do canal de anúncios (opcional): um ID de canal onde o txAdmin pode postar avisos de status/reinicialização.
- Salvar.
Adicione o Live Status Embed
- No canal do Discord escolhido, digite:
/status adicionar - txAdmin irá postar um incorporação persistente que é atualizado automaticamente com informações do servidor.
Personalize o status incorporado (opcional)
- Em txAdmin → Configurações → Discord, abrir Alterar JSON incorporado para editar título, descrição, campos, miniatura, botões/links, etc.
Etapa 4 — (Opcional) Lista de permissões com suporte do Discord no txAdmin
Você pode restringir o acesso ao servidor por meio de associação ou função no Discord.
- No txAdmin, vá para Configurações → Gerenciador de Jogadores.
- Modo de lista de permissões: escolha um dos seguintes:
- Membro do Discord – qualquer pessoa no seu Discord pode participar.
- Função no Discord – somente membros com IDs de função especificados podem participar.
- Se estiver usando Função no Discord, colete IDs de função (Configurações do servidor → Funções → clique com o botão direito do mouse na função → Copiar ID).
- Adicione os IDs de função às configurações da lista de permissões. Salvar.
Aprovar/Gerenciar solicitações:
- Vá para Gerente de Jogadores → Lista de Permissões para revisar solicitações e aprovações.
Prefira listas de permissões baseadas em funções para maior controle. Atualize seu fluxo de trabalho de atribuição de funções no Discord de acordo.
Solução de problemas
- O salvamento das configurações do Discord expirou → Garantir INTENÇÃO DOS MEMBROS DO SERVIDOR está habilitado para seu bot no Portal do Desenvolvedor do Discord.
- Os comandos de barra (/status, /info) não aparecem → Convide novamente o bot com o aplicações.comandos escopo; certifique-se de que ele pode ver o canal.
- O status não é publicado/atualizado → Verificar permissões do canal: o bot precisa Ver canal, Enviar mensagens, Incorporar links, Ler histórico de mensagens.
- Nenhuma mensagem do txAdmin → Verifique novamente o ID da guilda/ID do canal valores e que o Modo Desenvolvedor esteja habilitado ao copiar IDs.
- Ruído no canal de anúncios → Sair ID do canal de anúncios vazio em Configurações → Discord (o txAdmin não publicará anúncios automaticamente).
Notas de segurança
- Tratar o Token de bot como uma senha. Gire-a se estiver exposta.
- Evite conceder permissões de administrador ou desnecessárias.
- Restrinja o bot a um único canal de postagem quando possível.
Guias e recursos relacionados
- txAdmin (site oficial): https://txadmin.gg/
- Como configurar uma lista de permissões do Discord para seu servidor FiveM (FAXES/DiscordWhitelist) — fivemx.com: https://fivemx.com/discord-whitelist-fivem/
- Ferramenta de administração ESX / Gerenciador de jogadores com integração ao Discord (produto) — fivemx.com: https://fivemx.com/esx-admin-tool-player-manager-discord-integration/
Lista de verificação rápida (copiar/colar)
- Bot criado; INTENÇÃO DOS MEMBROS DO SERVIDOR habilitado
- Bot convidado com bot + aplicativos.comandos escopos
- Permissões: Visualizar, Enviar, Incorporar, Ler Histórico
- Token de bot + ID da guilda (e opcional ID do canal) salvo no txAdmin
/status adicionarcorrer no canal alvo- (Opcional) Modo de lista de permissões definido como Membro/Função do Discord; IDs de função salvos
Lista de verificação prática
Use este guia como uma lista de verificação antes de alterar um servidor FiveM em produção. Confirme a versão atual do artefato do servidor, a versão do framework, as dependências de recursos, as alterações no banco de dados e quaisquer arquivos do lado do cliente antes de aplicar a alteração.
- Faça backup dos arquivos de configuração e tabelas do banco de dados afetados.
- Aplique a alteração primeiro em um servidor de teste.
- Observe o console do servidor e o console F8 do cliente em busca de erros.
- Verifique se a alteração afeta empregos, inventário, veículos, mapas, voz, permissões ou dados do jogador.
- Documente o arquivo, comando ou configuração exata que você alterou para que possa ser revertida rapidamente.
Testes antes da produção
Após o primeiro teste, entre com uma conta de jogador normal e repita o fluxo da perspectiva do jogador. Se o tópico envolver desempenho, meça o antes e o depois com a mesma quantidade de jogadores, rota e conjunto de recursos. Se envolver ferramentas ou permissões de administrador, verifique os usuários permitidos e os bloqueados.
Erros comuns
A maioria dos problemas do FiveM decorre de dependências ausentes, cache desatualizado, nomes de pastas incorretos, incompatibilidade de frameworks ou configurações copiadas de outro servidor. Evite alterar vários sistemas ao mesmo tempo; faça uma alteração por vez, teste-a e só então continue.
Recursos relacionados
Para ativos prontos para produção, compare os recursos pagos no Loja FiveMX. Para recursos gratuitos, navegue. Scripts gratuitos para FiveM e testar cada recurso antes de utilizá-lo publicamente.
Notas sobre o lançamento da produção
Antes de usar este guia em um servidor FiveM ao vivo, defina o resultado exato que você espera da alteração. Para Como Conectar o txAdmin ao Discord, isso significa verificar qual recurso, configuração, comando ou fluxo de trabalho é afetado e confirmar que a alteração se encaixa no seu framework atual, versão do artefato e regras do servidor. Mantenha o lançamento pequeno o suficiente para que você possa revertê-lo rapidamente se os jogadores relatarem erros.
Utilize um servidor de testes com a mesma estrutura, esquema de banco de dados, ordem de recursos e principais dependências do servidor de produção. Se o tópico alterar a jogabilidade, permissões, visuais, voz, veículos, mapas, inventário ou comportamento da economia, teste com pelo menos uma conta de administrador e uma conta de jogador normal. Observe a saída do console do servidor, os logs do cliente (F8) e o tempo de uso dos recursos enquanto repete o fluxo exato de jogadores que ocorrerá no servidor de produção.
Lista de verificação de reversão
- Salve o arquivo de configuração anterior, a pasta de recursos e o estado do banco de dados antes de fazer qualquer alteração.
- Registre a versão do recurso, o commit, a página de download ou o valor da configuração que você testou.
- Reinicie primeiro apenas o recurso afetado, se possível, e só reinicie o servidor completo se as dependências assim o exigirem.
- Caso ocorram erros, reverta a alteração feita no recurso ou na configuração antes de testar outra correção.
Guia de manutenção
Revise esta configuração novamente após atualizações de artefatos do FiveM, atualizações do framework ou alterações importantes nos recursos. Uma configuração que funciona hoje pode parar de funcionar após atualizações de dependências, renomeação de exportações, alteração de eventos ou migrações de banco de dados. Mantenha anotações junto com a documentação do seu servidor para que os futuros administradores entendam o que foi alterado, por que foi alterado e como verificar novamente.
Revisão em andamento
Reverifique Como Conectar txAdmin ao Discord após atualizações importantes de artefatos FiveM, alterações de framework ou migrações de recursos. Confirme que o conselho ainda corresponde ao comportamento atual do servidor, que qualquer fonte vinculada permaneça disponível e que as etapas de instalação ainda correspondam aos arquivos que um proprietário do servidor realmente baixará ou configurará.
Para servidores públicos, mantenha um breve registro de alterações junto à documentação do servidor. Anote o que foi testado, o que foi alterado, quais contas foram usadas para verificação e como reverter as alterações. Isso agiliza a manutenção futura e evita que anotações antigas de configuração se tornem confusas ou inseguras para os jogadores.
Referências oficiais e verificação final
O documentação oficial do txAdmin lista seus recursos de embed e whitelist de status Discord. O guia de instalação do app e OAuth2 e referência de permissões explicam links de instalação atuais, escopos, permissões de bot e manipulação de token.
Após salvar as configurações Discord do txAdmin, verifique se o bot aparece apenas no guild pretendido, se o status embed é atualizado, se um membro normal não pode executar ações de admin, se um papel permitido passa na whitelist opcional e se um papel negado permanece bloqueado.
