Ir para o conteúdo principal
  • Entrega digital instantânea
  • Atualizações vitalícias em produtos selecionados
  • Aprovado por donos de servidores
FiveMX
Loja
Servidores CompletosPacotesLançamentos
FiveMX

Comece a construir seu servidor hoje.

Recursos FiveM selecionados, entrega instantânea, mods grátis para começar e guias práticos em um marketplace tranquilo.

Navegar na lojasupport@fivemx.com

Loja

  • Loja
  • Mods FiveM
  • Todos os produtos
  • Mods grátis
  • Melhores scripts & mods
  • Scripts FiveM

Frameworks

  • Scripts QBCore
  • Scripts ESX
  • QBox
  • Standalone

Comunidade

  • Blog
  • Suporte
  • Criadores
  • Afiliados

Jurídico

  • Política de privacidade
  • Termos de serviço
  • Política de reembolso
  • Entrega digital
  • Política de cookies
  • Conformidade LGPD/GDPR
  • DMCA
  • Informações legais
  • Política editorial

Templates de Servidor

  • Template de Servidor QBCore
  • Template de Servidor ESX
  • Template de Servidor NoPixel
  • Packs de Servidor
  • Templates Grátis
  • Alternativa ao Tebex
© 2026 FiveMX. Todos os direitos reservados.·FiveMX não é afiliado à Rockstar Games, Take-Two Interactive ou CFX.re. Todas as marcas são propriedade de seus respectivos donos.
DiscordDocs
  1. Início
  2. Blog
  3. Tutorials & Guides
Table of Contents
TL;DRThree Whitelist Approaches: Which One Fits Your Server?

Como configurar uma Whitelist do Discord para o seu servidor FiveM (Guia 2026)

Publicado em 17 de agosto de 2025·por Lars Miller(Founder & Lead Editor)·Credenciais·2 min de leitura·Atualizado em 18 de maio de 2026
Tutorials & Guidesdiscord whitelist fivem

Proteja o acesso ao seu servidor FiveM com uma whitelist baseada em cargo do Discord. Aborda três abordagens de implementação (Discord puro, baseado em identificador, híbrido), configuração passo a passo do bot, exemplos funcionais para QBCore e ESX, erros comuns que quebram a autenticação e reforço de segurança.

Share
Como configurar uma Whitelist do Discord para o seu servidor FiveM (Guia 2026)
Como configurar uma Whitelist do Discord para o seu servidor FiveM (Guia 2026)

A Discord whitelist gates access to your FiveM server using Discord roles. Players without the right role can't join, moderators can grant or revoke access from their phone via a role toggle, and every grant is logged in Discord's audit trail.

This guide covers three implementation approaches, step-by-step bot setup, working configurations for both QBCore and ESX, common mistakes that silently break auth, and security hardening for production servers.

Note on versions: The open-source FAXES/DiscordWhitelist repo is community-maintained and last updated in 2022. It still works for most servers. Several commercial forks exist with active maintenance and SLA support. This guide covers the free GitHub version and the patterns apply to any Discord-based whitelist.

TL;DR

FiveM Discord Whitelist System Setup

  1. Create a Discord Bot in the Developer Portal → enable Server Members Intent → invite to your guild.
  2. Copy your Guild (Server) ID and Role ID(s).
  3. Download FAXES/DiscordWhitelist into resources/ and configure server.js.
  4. Add ensure DiscordWhitelist to server.cfg.
  5. Test: join without the role (blocked), grant the role, rejoin (allowed).

Three Whitelist Approaches: Which One Fits Your Server?

Before picking an implementation, decide which of these three approaches matches your operational reality:

| Approach | How it works | Pros | Cons | Best for | |

Perguntas Frequentes

Por que usar o Discord para whitelist em um servidor FiveM?

A whitelist via Discord é dinâmica (concede acesso adicionando uma role, sem editar ACE ou DB), escalável (moderadores podem gerenciar o acesso pelo Discord mobile) e auditável (histórico de roles do Discord + logs de auditoria mostram quem concedeu o quê). A principal desvantagem em comparação com a whitelist baseada em identificadores é que os jogadores precisam ter o aplicativo desktop do Discord aberto ao conectar, o que torna o Discord uma dependência obrigatória para entrar no servidor.

Qual abordagem de whitelist devo escolher: apenas Discord, baseada em identificadores ou híbrida?

A verificação pura por role do Discord é a mais simples e melhor para servidores com menos de 500 jogadores simultâneos — uma única role do Discord controla tudo. A baseada em identificadores (tabela SQL de Steam/license IDs permitidos) é a mais segura e independente do Discord, ao custo de gerenciar a lista manualmente. A híbrida combina ambas: role do Discord para a maioria dos jogadores, whitelist por identificadores como fallback para VIPs/admins quando a API do Discord estiver offline. A híbrida é a resposta certa para servidores sérios.

O que preciso para configurar uma whitelist pelo Discord?

Quatro coisas: (1) um servidor Discord onde você seja admin, (2) um servidor FiveM com acesso ao txAdmin ou CLI, (3) jogadores com o aplicativo desktop do Discord aberto antes de iniciar o FiveM (para que o FiveM exponha o identificador discord:) e (4) um bot criado no Portal do Desenvolvedor do Discord com a intent Server Members ativada.

Como corrigir o erro 'Bot offline'?

Table of Contents

TL;DRThree Whitelist Approaches: Which One Fits Your Server?

More on This Topic

Move from research to a production-ready server stack

Once you know the direction, jump into the highest-leverage commercial hubs for verified scripts, curated bundles, and framework-specific buying paths.

Framework hub

Move into the QBCore landing page to compare verified scripts, framework fit, and install-ready products built for modern FiveM servers.

Open QBCore hub

Premium catalog

Move from research into the main shop to compare real products, framework labels, screenshots, and production-ready quality signals.

Open premium shop

Launch faster

Bundles shorten the path from planning to launch by grouping the highest-leverage scripts into a cleaner commercial starting point.

View bundles

Divulgação: Alguns links abaixo são links de afiliados para produtos FiveMX. Podemos ganhar uma comissão sem custo adicional para você.

Scripts Premium que Você Pode Gostar

Free Scripts You Might Like

Artigos Relacionados

Configurar Whitelist do Discord para FiveM: guia alemão do FiveM com checklist prática, dicas de configuração e recursos internos para operadores de servidores.

May 18, 2026

Manter um servidor FiveM de alta qualidade custa dinheiro. Entre hospedagem VPS, proteção DDoS dedicada e a compra de scripts FiveM premium, as despesas mensais rapidamente se acumulam.

November 12, 2024

Sua logo de servidor é a primeira coisa que um potencial jogador vê — antes mesmo de ler sua descrição, verificar o número de jogadores ou visitar seu Discord.

April 4, 2026

Três causas: token do bot errado no config, o bot não foi convidado para o servidor ou a intent Server Members não foi ativada no Portal do Desenvolvedor. Verifique se o token começa com o prefixo correto, confirme se o bot aparece na lista de membros do seu Discord (offline é ok, ausente não) e ative ambas as Intents na aba Bot do Portal do Desenvolvedor: Server Members Intent ON, Presence Intent pode ficar OFF.

Jogadores estão sendo bloqueados mesmo com a role de whitelist. O que está errado?

A causa mais comum é o aplicativo desktop do Discord não estar rodando quando o jogador inicia o FiveM — sem ele, o FiveM não consegue expor um identificador discord: para o script. Peça ao jogador para reiniciar o Discord, aguardar o carregamento completo e então iniciar o FiveM. Se não resolver, o cache de membros do servidor do bot está desatualizado — reduza o cacheMaxTime no config de 90s para 30s.

Posso usar múltiplas roles de whitelist (Doador, Staff, Aprovado)?

Sim. Adicione cada ID de role ao array whitelistRoles no config. O acesso é concedido se o jogador tiver qualquer uma das roles listadas. É assim que a maioria dos servidores lida com diferenciação de fluxos — uma role para aprovados, outra para doadores, uma terceira para staff com acesso automático.

Como evitar condições de corrida onde mudanças de role levam minutos para serem aplicadas?

Duas coisas: reduza cacheMaxTime para 30-60 segundos para que o bot atualize os dados da role com mais frequência; e, se precisar de atualizações instantâneas, implemente um webhook no evento de mudança de role do Discord que invalide o cache imediatamente. Sem o webhook, jogadores que acabaram de receber uma role serão negados até o próximo refresh do cache — irritante, mas geralmente não vale o esforço de implementação a menos que você tenha alta rotatividade de aprovados.

A whitelist via Discord é segura contra tentativas de bypass?

O ponto fraco é o token do bot. Se vazar, atacantes podem se passar pelo bot, ler a lista de membros do seu servidor e potencialmente se inserir na whitelist. Armazene o token fora do controle de versão (env var ou convar), rotacione se vazar e restrinja quem tem acesso de escrita à pasta do resource. Para servidores de alto valor, combine a whitelist do Discord com um fallback baseado em identificadores — assim, mesmo um comprometimento total do Discord não concede acesso ao servidor.

Artigo Anterior

Como avaliar, testar e manter scripts do FiveM

Próximo Artigo

Como Conectar o txAdmin ao Discord (Guia 2026)

Como configurar um servidor FiveM GTA RP (2026) — Guia completo passo a passo
Crie um logotipo para seu servidor de jogos ou comunidade (Guia 2026)
Criando níveis de doação no Discord para servidores FiveM
Como Encontrar Jogadores para o Seu Servidor FiveM
Como Instalar um Template de Servidor FiveM (2026) — Guia Passo a Passo
Browse QBCore-ready scripts
Browse premium FiveM scripts
Compare curated bundles
ADN’s Whitelist System

ADN’s Whitelist System

$11.49
Password Whitelist Script

Password Whitelist Script

$7.49
Active Duty Officer — Active Officer Display & Access Control

Active Duty Officer — Active Officer Display & Access Control

$13.00
Infinity Server (Dutch)

Infinity Server (Dutch)

$109.99
Gameconfig for Legacy & Enhanced

Gameconfig for Legacy & Enhanced

8,243,364 downloads
PC Trainer V

PC Trainer V

1,272,946 downloads
LemonUI: Open Source UI Library

LemonUI: Open Source UI Library

1,138,096 downloads
NFS gauge - RPM Gear Speedometer & Timer

NFS gauge - RPM Gear Speedometer & Timer

1,058,515 downloads
Configurar whitelist do Discord para FiveM
Configurar whitelist do Discord para FiveM
Como Criar Níveis de Doação no Discord para o Seu Servidor FiveM
Como Criar Níveis de Doação no Discord para o Seu Servidor FiveM
Como Criar um Logotipo para Seu Servidor ou Comunidade de Jogos (Guia 2026)
Como Criar um Logotipo para Seu Servidor ou Comunidade de Jogos (Guia 2026)

Sem tempo para configurar tudo você mesmo?

Comece com um pacote de servidor FiveM pré-construído e testado. Otimizado para frameworks, todos os scripts pré-instalados.

Super ESX Server
esxstandalone

Super ESX Server

The Super ESX Server is one of the best FiveM server templates - over 1.000 purchases! Want to know why we call it our Super Server? Check out our video to find out some of the basics details of the world. Update 10 is included, make sure to install v7 first and then use content of v10 yo

$228.32
ESX Server Base (by RibSosay)
esxstandalone

ESX Server Base (by RibSosay)

Prebuilt FiveM server with ESX framework GUARANTEE : We offer a guarantee ensuring compatibility with your setup.

$53.99
Ver todos os pacotes de servidor