Como configurar uma lista branca do Discord para o seu servidor FiveM (…

Público: Proprietários e desenvolvedores de servidores FiveM
Dificuldade: Fácil → Intermediário
Resultado: Lista de permissões baseada em funções usando funções do Discord (com lista negra opcional), manutenção mínima, feedback claro do jogador.

Nota sobre versões: O repositório de código aberto FAXES/Lista de permissões do Discord é mantido pela comunidade e atualizado pela última vez em 2022. Ainda funciona para muitos servidores. Existe uma versão comercial mantida; se precisar de suporte/SLA, considere fazê-lo. Este guia aborda a versão gratuita GitHub.

---

Resumo

1. Criar um Discord Robô → habilitar Intenção dos membros do servidor → convide-o para seu Discord.
2. Copie seu ID da guilda (servidor) e ID(s) de função.
3. Download: FAXES/DiscordWhitelist em GitHub → coloque-o em recursos/ → configurar servidor.js.
4. Adicionar garantir DiscordWhitelist para servidor.cfg (ou comece no txAdmin).
5. Teste: ingressar sem a função (bloqueado) → adicionar função → reingressar (permitido).

Tutoriais relacionados:
• FiveM Whitelist — Guia completo (txAdmin, scripts, banco de dados)
• Como criar níveis de doação no Discord

---

Por que a lista de permissões baseada no Discord?

• Dinâmico: Conceda/negue acesso adicionando/removendo uma função do Discord — sem edições no ACE ou no DB.
• Escalável: Os moderadores podem gerenciar o acesso do Discord no celular.
• Auditável: O histórico de funções + registros de moderação mostram quem permitiu quem.

---

Pré-requisitos

• Um servidor Discord (você é Administrador/Proprietário).
• Servidor FiveM com txAdmin ou controle manual.
• Os jogadores devem ter o Aplicativo Discord para desktop em execução ao conectar (então FiveM expõe um discórdia: identificador).

---

Etapa 1 — Crie um bot do Discord e habilite as intenções

1. Vá para o Portal do Desenvolvedor Discord → Novo aplicativo → nomeie-o (por exemplo, Bot de lista de permissões FiveMX).
2. Adicionar um bot (Aba do bot) → Token de redefinição → copiar o Token de bot (guarde-o com segurança).
3. Sob Intenções de Gateway Privilegiadas, habilitar Intenção dos membros do servidor. (A intenção de presença não é necessária.)
4. Convidar o bot para seu Discord: OAuth2 → Gerador de URL → Escopos: robô; Permissões: mínimas (podem ser nenhuma, exceto para entrar). Use a URL gerada e adicione-a à sua guilda.

Segurança: Trate o token do bot como uma senha. não Envie para o Git ou compartilhe em capturas de tela. Gire se houver vazamento.

---

Etapa 2 — Obtenha suas IDs (Guilda e Funções)

• No Discord → Configurações do usuário → Avançado → Modo de desenvolvedor: SOBRE.
• Clique com o botão direito do mouse em seu nome do servidor → Copiar ID do Servidor.
• Configurações do servidor → Funções → clique com o botão direito na função que você usará como lista de permissões (por exemplo, Na lista de permissões) → Copiar ID da função.
• (Opcional) Copie os IDs de todas as funções que você deseja lista negra (por exemplo, Proibido).

Mantenha estes à mão:

• ID_GUILD = 123456789012345678
• WHITELIST_ROLE_IDS = ["11111111111111111111", "222222222222222222"]
• BLACKLIST_ROLE_IDS = ["3333333333333333333"]

---

Etapa 3 — Baixe e instale o recurso

1. Download o CEP de FAXES/Lista de permissões do Discord (GitHub).
2. Extraia para seu servidor em:
   recursos/[discord]/DiscordWhitelist
3. Verifique se a pasta contém pelo menos:
   • fxmanifest.lua
   • servidor.js
   • pacote.json

servidor.cfg (ou txAdmin Receita / Startup):

# Comece depois dos seus provedores de identificadores e antes da lógica de adesão que depende deles, garanta a DiscordWhitelist

Em txAdmin → Recursos, marca DiscordLista de permissões para iniciar na inicialização (se você gerencia recursos via interface do usuário).

Planejando sua estratégia de acesso? Leia nosso guia mais amplo: FiveM Whitelist — Guia completo (txAdmin, scripts, banco de dados) para alternativas (ACE, DB, híbrido) e quando usar cada uma.

---

Etapa 4 — Configurar servidor.js

Abrir recursos/[discord]/DiscordWhitelist/server.js e defina o bloco de configuração. O arquivo pode já expor um objeto de configuração simples — ajuste os valores de acordo. Uma configuração típica se parece com isto:

// Configuração do DiscordWhitelist — exemplo const config = { botToken: "PASTE_YOUR_DISCORD_BOT_TOKEN_HERE", guildId: "123456789012345678", // ID do seu servidor (guilda) // Os jogadores devem ter pelo menos UM desses IDs de função para entrar na whitelistRoles: [ "1111111111111111111", // Na lista de permissões // "222222222222222222", // Equipe (opcional) ], // Se um jogador tiver QUALQUER uma dessas funções, rejeitar a conexão blacklistRoles: [ // "333333333333333333", // Banido ], // Armazenar em cache os dados da função buscada para reduzir as chamadas da API do Discord (segundos) cacheMaxTime: 90, // Mensagens de adiamento messages: { noDiscord: "Abra o Discord e entre novamente. Seu aplicativo Discord deve estar em execução.", notWhitelisted: "Você não está na lista de permissões. Junte-se ao nosso Discord: discord.gg/yourinvite", blacklisted: "Acesso negado. Entre em contato com a equipe.", welcome: "Bem-vindo — você foi verificado. Carregando…" }, };

Dica de monetização: Se o seu servidor usa vantagens, combine isso com Níveis de doação do Discord para automatizar benefícios baseados em funções para apoiadores/doadores.

Salve o arquivo.

---

Etapa 5 — Reiniciar e testar

1. Reiniciar apenas o recurso ou o servidor inteiro: txAdmin → Reiniciar recurso ou console atualizar então reiniciar DiscordWhitelist.
2. Teste negativo:Tente conectar sem a função de lista de permissões → você deverá ver a mensagem de adiamento e ser expulso.
3. Teste positivo:Conceda a si mesmo a função de lista de permissões → reconecte-se → você deve ter permissão para entrar.

---

Opcional: Múltiplas Funções e Ignorar Equipe

• Adicionar várias funções de lista de permissões para permitir múltiplos funis (por exemplo, Doador, Polícia, EMS).
• Adicionar funções na lista negra para blocos rígidos, independentemente da lista de permissões (por exemplo, Proibido).
• Você pode incluir um função da equipe em funções da lista de permissões para garantir acesso aos administradores.

---

Dicas Operacionais

• Automação: Conecte a atribuição de função do Discord ao seu formulários de inscrição ou aprovações de tickets (por exemplo, com um bot, Google Forms → webhook → adicionar função).
• UX do jogador: Fixar um 1TP13Como colocar na lista de permissões publique com ✅ requisitos de função e seu convite para o servidor.
• Moderação: Registrar alterações de função em um privado #mod-logs canal.

---

Solução de problemas

“Bot offline” ou nunca atualiza funções

• Token errado ou bot não foi convidado para a guilda correta.
• Intenção dos membros do servidor não habilitado.
• O firewall bloqueia HTTPS de saída do seu host de jogo (permite a API do Discord).

“Nenhum identificador do Discord encontrado” / todos bloqueados

• Os jogadores devem executar o Aplicativo de desktop Discord antes de iniciar o FiveM. Peça para reiniciarem o Discord e depois o FiveM.

As alterações de função só se aplicam após uma reinicialização

• Reduzir TempoMáximoCache para 30–60 segundos.
• Se você definir um valor extremamente baixo e ainda observar atrasos, verifique os limites de taxa e evite reiniciar com frequência.

403/Erro de permissão ao buscar membros da guilda

• Certifique-se de que o bot esteja na guilda alvo e A intenção dos membros do servidor está habilitada.
• O bot faz não precisa de permissões de administrador para ler funções de membros.

Alto uso de API/limitação de taxa

• Aumentar TempoMáximoCache. Evite reinicializações/expulsões em massa que geram spam em chamadas de API.

---

Melhores práticas de segurança

• Armazene o Token de bot Fora do controle de versão. Se você hospeda configurações por conta própria, considere lê-las a partir de uma variável de ambiente ou da convar server.cfg, e não em texto simples enviado ao Git.
• Girar o token se vazou.
• Restrinja quem tem acesso de gravação ao recurso.

---

Desinstalar / Desativar

• Remover garantir DiscordWhitelist de servidor.cfg (ou desabilitar em txAdmin → Recursos).
• Remova a pasta de recursos/ se você estiver desativando-o.

---

Perguntas frequentes

Os jogadores precisam ter o Discord funcionando?
Sim. Sem o discórdia: identificador, o script não pode verificar funções.

Quais intenções eu preciso?
Apenas Intenção dos membros do servidor.

Posso usar várias funções de lista de permissões?
Sim. O acesso é concedido se o usuário tiver qualquer das funções listadas.

Posso negar terminantemente certas funções?
Sim. Adicione-os a lista negraFunções.

Parou de funcionar depois que troquei de função.
Mais baixo TempoMáximoCachee teste novamente. Certifique-se de que o bot esteja online com o token e a guilda corretos.

Existe uma versão mantida?
Sim. Existe uma edição comercial, mantida ativamente, caso você precise de atualizações/suporte.

---

Apêndice — Exemplo servidor.cfg

# Discord whitelist garante DiscordWhitelist # (Opcional) coloca recursos relacionados do Discord aqui como um bloco # garante discord_perms # garante discordrolesync

Apêndice — Exemplo de mensagens do jogador (adiamentos)

Mantenha as mensagens curtas e práticas:

messages: { noDiscord: "Abra o Discord e entre novamente. Seu aplicativo Discord precisa estar em execução.", notWhitelisted: "Não está na lista de permissões. Inscreva-se em #how-to-whitelist → discord.gg/yourinvite", blacklisted: "Acesso negado. Contate a equipe por tíquete.", welcome: "Verificado — carregando cidade…" }

---

Log de alterações (voltado para o editor)

• v1.1 — Adicionados links internos naturais para níveis de doação, guia completo da lista de permissões do FiveM e download do GitHub.
• v1.0 — Guia inicial: criação de bots, intenções, IDs, instalação, configuração, testes, perguntas frequentes.