Whitelist FiveM pelo Discord com txAdmin: passo a passo completo
Com o txAdmin, a whitelist da sua cidade FiveM pode depender de um único cargo do Discord: quem tem o cargo @Whitelist entra, quem não tem é barrado na porta. Junte a isso um bot de candidatura que dá esse cargo quando a staff aprova, e aprovar a candidatura já libera o jogador. Sem licença pra copiar, sem comando no console.
Este guia leva uns 15 minutos, do zero até a primeira candidatura aprovada.
Como funciona
Três peças, cada uma com uma função:
| Peça | O que faz |
|---|---|
| O cargo @Whitelist | A chave da sua cidade FiveM |
| Toscio | Recebe as candidaturas no Discord e dá o cargo quando a staff aprova |
| txAdmin | Confere o cargo a cada conexão e recusa quem não tem |
Do lado do jogador: ele entra no seu Discord, clica em Candidatar-se, preenche o formulário da WL, recebe uma DM de “candidatura aceita”, abre o FiveM e conecta. Ninguém da staff precisou abrir o txAdmin.
Este guia segue os menus do txAdmin 8, que vem com as versões recentes do FXServer. Os nomes das opções podem mudar um pouco de uma versão pra outra. O txAdmin é em inglês: deixamos os nomes das opções como aparecem nele.
Antes de começar
Você precisa de:
- um servidor FiveM rodando com txAdmin, e uma conta no txAdmin com permissão para mudar as configurações;
- a permissão Gerenciar servidor no seu Discord;
- o Modo desenvolvedor do Discord ativado, para copiar IDs: Configurações de usuário → Avançado → Modo desenvolvedor.
1. Crie o cargo @Whitelist
- No seu Discord, abra Configurações do servidor → Cargos → Criar cargo.
- Dê o nome de Whitelist (ou WL, Cidadão… o nome não importa).
- Clique com o botão direito no cargo e escolha Copiar ID do cargo. Guarde esse número.
Sua cidade tem uma etapa de visitante ou de entrevista? Crie também um cargo @Visitante: o Toscio pode removê-lo quando a candidatura for aprovada.
2. Crie o bot do Discord do txAdmin
O txAdmin precisa de um bot próprio para ler os cargos dos seus jogadores. Não é o Toscio: é um bot seu, usado só pelo txAdmin.
- Entre no Discord Developer Portal e clique em New Application. Dê o nome da sua cidade.
- Na aba Bot, clique em Reset Token e copie o token. Nunca compartilhe: ele dá controle total do bot.
- Ainda em Bot, ative Server Members Intent e salve. Sem isso, o txAdmin não enxerga os cargos.
- Em OAuth2 → URL Generator, marque o escopo bot, abra o link gerado e adicione o bot ao seu servidor do Discord.
Se o txAdmin não salva as configurações do Discord ou fica travado, quase sempre o motivo é o Server Members Intent desligado.
3. Conecte o bot no txAdmin
- No txAdmin, abra Settings e depois a aba Discord.
- Ative Discord Bot.
- Cole o token em Token.
- Em Guild/Server ID, cole o ID do seu servidor do Discord (botão direito no nome do servidor, Copiar ID do servidor).
- Salve.
4. Coloque o txAdmin em whitelist por cargo do Discord
- Ainda em Settings, abra a aba Whitelist.
- Em Allowlist Mode, escolha Discord Server Roles.
- Em Allowlisted Discord Roles, cole o ID do cargo @Whitelist. Dá pra colocar vários, separados por vírgula (por exemplo @Whitelist e @Staff).
- Em Allowlist Instructions, explique para quem for barrado como se candidatar, por exemplo: “Entre em discord.gg/suacidade e faça a WL em #whitelist.”
- Salve.
A partir de agora, o txAdmin recusa todo jogador sem o cargo. Dê o cargo pra você e pra sua staff antes de testar.
5. Receba as candidaturas com o Toscio
Só falta dar o cargo automaticamente.
- Adicione o Toscio ao seu Discord.
- Em Configurações do servidor → Cargos, arraste o cargo Toscio para cima do @Whitelist. O Discord só deixa um bot dar cargos que estão abaixo do dele.
- Use
/toscio setupcom:template: Whitelist RP;channel: onde os jogadores se candidatam, por exemplo#whitelist;staff-channel: um canal privado para a equipe da WL, por exemplo#wl-staff;role: @Whitelist;staff-role: o cargo da sua equipe de WL, se tiver um.
O Toscio publica o painel com o botão Candidatar-se e confirma onde as candidaturas vão chegar. Seu primeiro formulário vem com 14 dias de Premium grátis, sem cartão: a whitelist completa, com todas as perguntas.
Para escolher as perguntas, veja as 53 perguntas de whitelist FiveM e depois edite o formulário no editor de formulário. Nas configurações do formulário, você também pode pedir para remover o @Visitante na aprovação.
6. Teste o fluxo completo
Com uma segunda conta do Discord, ou com um amigo:
- Clique em Candidatar-se, preencha a whitelist e envie.
- Em
#wl-staff, clique em Aceitar na ficha da candidatura. - Confira se a conta recebeu o @Whitelist e a DM de confirmação.
- Abra o aplicativo do Discord no PC, abra o FiveM e conecte: você entra.
- Tire o cargo e tente de novo: o txAdmin recusa você com a sua mensagem de instruções.
O que a staff vê
Cada candidatura chega no canal da staff com as respostas, a idade da conta do Discord e a data em que o jogador entrou no seu servidor, e três botões:
- Aceitar: o Toscio dá o @Whitelist e manda uma DM pro jogador no idioma dele. Ele já pode conectar.
- Recusar: com um motivo, pra o jogador saber o que melhorar. Um tempo de espera de 24 horas (ajustável) evita spam de candidaturas.
- Entrevista: abre um tópico privado com o jogador. Prático pra marcar uma entrevista em call e aprovar depois.
Erros comuns
| Mensagem ou sintoma | Causa | Solução |
|---|---|---|
| “You do not have the discord identifier” | O FiveM não encontra a conta do Discord do jogador | Abrir o aplicativo do Discord no PC (não o navegador) antes de abrir o FiveM |
| “You are required to join our Discord server” | O jogador não está no Discord configurado no txAdmin | Conferir o Guild/Server ID e se o jogador entrou no servidor certo |
| “You do not have a allowlisted role” | O jogador não tem o cargo, ou o ID colado está errado | Conferir o ID do cargo na aba Whitelist |
| Aprovar dá erro no Toscio | O cargo do Toscio está abaixo do @Whitelist | Subir o cargo do Toscio em Configurações do servidor → Cargos |
| O txAdmin não salva as configurações do Discord | Intent faltando | Ativar Server Members Intent no Developer Portal |
O jogador precisa usar a mesma conta do Discord com que se candidatou: o txAdmin confere o cargo da conta do Discord aberta no PC dele.
E a whitelist por licença?
O txAdmin também tem o modo Approved License: cada jogador precisa ser aprovado na mão na página Allowlist do txAdmin, com um ID de solicitação. Funciona, mas alguém da staff tem que fazer isso pra cada jogador, além de ler a candidatura.
Com um cargo do Discord, a decisão e o acesso são a mesma coisa. Tirar o cargo tira o acesso, dá pra liberar a staff com um segundo cargo, e todo o histórico da whitelist fica no Discord.
Indo além
- Apelação de ban: um jogador banido do seu Discord não consegue mais se candidatar. Com o formulário web e a apelação de ban, ele apela por uma página web e o Toscio remove o ban se a staff aprovar.
- Votação da staff: vários membros da equipe de WL votam em cada candidatura, e o Toscio decide quando houver votos suficientes.
- Vários formulários: whitelist civil, polícia, SAMU, staff… cada um com o próprio cargo e canal. Veja a página de whitelist FiveM.
Perguntas
Como fazer a whitelist do FiveM pelo Discord?
No txAdmin, ative o bot do Discord (aba Discord), depois escolha o modo “Discord Server Roles” na aba Whitelist e cole o ID do seu cargo @Whitelist. Só quem tem esse cargo no seu Discord consegue conectar. Um bot de candidatura como o Toscio dá o cargo quando a staff aprova a candidatura.
Por que o jogador recebe “You do not have the discord identifier”?
O FiveM não encontrou a conta do Discord dele. O jogador precisa abrir o aplicativo do Discord no PC (não a versão do navegador) antes de abrir o FiveM, e depois conectar de novo.
O txAdmin precisa de um bot do Discord próprio além do Toscio?
Sim. O txAdmin usa um bot próprio, criado no Discord Developer Portal, para ler os cargos dos jogadores. O Toscio cuida das candidaturas e dá o cargo. Os dois funcionam lado a lado sem atrapalhar um ao outro.
Como tirar alguém da whitelist?
Tire o cargo @Whitelist dele no Discord. O txAdmin confere o cargo a cada conexão, então ele vai ser recusado na próxima tentativa.
A whitelist por cargo do Discord funciona com ESX e QBCore?
Sim. O txAdmin faz a verificação quando o jogador conecta, antes da base entrar em ação. Funciona igual com ESX, QBCore, Qbox ou uma base própria.
