A whitelist é a portaria da sua cidade. Pelo Discord, a pessoa responde às perguntas, passa pela equipe (se você quiser) e, no fim, manda o ID do jogo num painel. O bot libera esse ID na hora, dá o cargo de acesso e troca o apelido. Com o recurso fivedash instalado no servidor FiveM, o ID também é liberado dentro do jogo. Esta página é para donos e equipe que configuram e analisam whitelists.
Plano: a whitelist faz parte do módulo Discord, em todos os planos (Plus, Pro e Ultra).
Bot conectado: o bot da cidade precisa estar ligado ao servidor do Discord. Veja Bot.
Cargos acima: o cargo do bot precisa ficar acima dos cargos que ele dá e tira (aprovado, liberado, entrevista, cargo a remover). Senão, o bot avisa “o cargo do bot precisa ficar acima dele”.
Liberação no jogo (opcional): instale o recurso fivedash e conecte o servidor. Veja Instalar o recurso.
Permissões no painel (área Whitelist):
Nível
O que libera
Ver
Whitelists, entrevistas e liberados (Visão geral, fichas, lista de codiguinhos e quem usou)
Gerenciar
Aprovar, recusar e gerar codiguinhos (também desativar, reativar e excluir códigos)
Configurar
Perguntas, modos e painéis (salvar configurações, publicar, reenviar e apagar painéis)
Abra Discord → Whitelist. O topo da página tem a chave Ativa / Desativada, o botão Publicar painéis (vira Reenviar painéis depois da primeira vez) e, no menu de três pontos, Apagar painéis. Abaixo, quatro abas:
Aba
O que tem
Visão geral
Números da whitelist, quadro ou lista de whitelists, fila da entrevista e Liberados
Configurações
Modo, Etapas (início, perguntas, entrevista), Regras, Resultado no canal e Registros
Liberação
Painel de liberação, formulário, o que acontece Ao liberar, Comando /liberar e Na cidade
Codiguinhos
Painel do codiguinho e a lista de Códigos. Só aparece nos modos Análise manual e Só entrevista
Cada aba tem uma Prévia no Discord ao lado. Alterações ficam marcadas com um ponto na aba até você clicar em Salvar (ou Descartar).
Em Discord → Whitelist → Configurações, no grupo Modo, clique no cartão do modo que a cidade usa.
Monte o início
Em Etapas, abra Início e escolha o Canal do painel: é onde o bot posta a mensagem com o botão Fazer whitelist. Clique em Título, texto, botão e imagem para mudar os textos. (Os modos Só entrevista e Só liberação não têm esse painel.)
Escreva as perguntas
Em Perguntas, clique em Adicionar pergunta. Para cada uma, preencha Pergunta, escolha o Tipo e, em múltipla escolha, crie as Opções e clique no círculo da resposta certa. Arraste para reordenar; use Duplicar e Excluir no menu da pergunta.
Decida sobre a entrevista
No cartão Entrevista, use Ligar a entrevista se quem passa ainda deve conversar com a equipe. Escolha o Cargo durante a entrevista, as Salas de espera (voz) e monte a colinha.
Ajuste as regras
No grupo Regras, defina Nota para passar, Tempo para responder, Canal privado, Tentar de novo e Canal da equipe.
Configure a liberação
Vá para a aba Liberação e escolha o Canal, o Cargo de quem foi aprovado e o Cargo de quem foi liberado. Veja a seção Liberação abaixo.
Ative, salve e publique
Ligue a chave Ativa, clique em Salvar e depois em Publicar painéis. O aviso Painéis publicados mostra onde eles estão.
Recebe uma pergunta por vez (“Pergunta 1 de 6”), com o tempo que falta. Múltipla escolha abre uma lista; respostas escritas abrem um formulário pelo botão Responder. Há sempre Cancelar e, em perguntas opcionais, Pular.
No fim:
Perguntas automáticas: recebe a nota na hora. “Você passou!” (ou “Você passou no quiz!”, se tiver entrevista) ou “Não foi dessa vez”, com quando pode tentar de novo.
Análise manual: “Respostas enviadas”. O resultado chega na DM, então a pessoa precisa deixar as mensagens diretas abertas.
Com Canal privado ligado, cada pessoa responde num canal só dela, criado ao começar e apagado ao terminar. Nesse canal, se o bot tiver a intent Message Content ligada, respostas escritas são digitadas direto no chat (“Responda aqui no chat.”), sem formulário.
A entrevista é uma conversa com a equipe antes da liberação. Ela é opcional em Perguntas automáticas e Análise manual (chave Ligar a entrevista no cartão Entrevista) e sempre existe em Só entrevista.
Campo
O que faz
Modos
Padrão
Cargo durante a entrevista
Opcional. Dado enquanto a pessoa espera; sai quando a entrevista termina
Automático, manual
Nenhum
Mensagem na DM
Vai na DM de quem passa no quiz (ou de quem teve as respostas aprovadas)
Automático, manual
“Agora falta a entrevista, {membro}! Fique de olho no Discord, a equipe vai te chamar para uma conversa.”
Canal das entrevistas
Opcional. O canal onde a equipe entrevista. Quem tentar a liberação antes de ser aprovado é mandado para lá
Só entrevista
Nenhum
Salas de espera (voz)
Até 10 canais de voz. Em Só entrevista, quem entra numa sala entra sozinho na fila. Nos outros modos, quem já espera aparece como “na sala”
Todos com entrevista
Nenhuma
Colinha da entrevista
Até 20 perguntas para guiar a conversa, cada uma com “O que esperar da resposta”. Só a equipe vê
Em Discord → Whitelist → Visão geral, a coluna Aguardando entrevista mostra quem está na sala de espera, ao vivo, com quanto tempo está esperando. A coluna Entrevista mostra quem espera fora da sala.
Abra a ficha e a colinha
Clique no cartão da pessoa. A ficha mostra como ela chegou (quiz, respostas aprovadas, sala de espera ou codiguinho). Ao lado, a Colinha da entrevista: marque o que já perguntou. Em Só entrevista, use o botão Abrir colinha.
Decida
Depois da conversa, clique em Aprovar entrevista ou Reprovar. Ao recusar, escreva o Motivo (opcional, até 500 caracteres): ele vai na DM da pessoa.
Em Discord → Whitelist → Visão geral, alterne entre Quadro e Lista em Modo de exibição. Busque por nome ou ID do Discord e filtre por status. Analisar exige o nível Gerenciar.
Perguntas automáticas sem entrevista, ou Só liberação
Sem quadro: só a lista
Arraste um cartão para a coluna da decisão (“Solte para aprovar”, “Solte para recusar”, “Solte para mandar à entrevista”). Pelo teclado: espaço para pegar, setas para escolher a coluna, espaço para soltar, Esc para cancelar. Com entrevista na análise manual, a aprovação final acontece na ficha.
Clique numa whitelist para ver Começou, Nota (por exemplo, “3 de 4 · 75%”), Decidida por, Tempo até decidir e cada resposta (com a certa, nas de múltipla escolha). Os botões mudam com a etapa:
Etapa
Botões
Em análise, sem entrevista
Aprovar · Recusar
Em análise, com entrevista
Aprovar para entrevista · Recusar
Entrevista
Aprovar entrevista · Reprovar
Se outra pessoa da equipe decidir antes, o painel avisa “Outra pessoa decidiu essa whitelist agora há pouco.”
O topo da Visão geral mostra os números dos últimos dias, comparados aos 7 dias anteriores: entradas (Quizzes feitos, Whitelists enviadas ou Pediram entrevista, conforme o modo), Nota média no quiz, Aguardando entrevista ou Na fila da equipe, Reprovados, Tempo até decidir, Aprovadas (com a taxa de aprovação) e Liberados.
A liberação é automática: quem foi aprovado manda o ID do jogo pelo painel e o bot libera na hora, sem ninguém da equipe precisar fazer nada. No modo Só liberação, qualquer pessoa usa o painel. Configure em Discord → Whitelist → Liberação.
Só quem tem esse cargo usa o painel. O bot dá o cargo a quem passa na whitelist (em Só entrevista, a equipe dá depois da entrevista), e ele sai quando o ID é liberado. Não existe em Só liberação
Nenhum (obrigatório)
Marcar quem foi aprovado
Quando a whitelist é aprovada, o bot marca a pessoa neste canal e apaga a mensagem logo depois: o canal fica destacado
Na hora, a pessoa ganha o cargo de liberado, perde o de aprovado, tem o apelido trocado e, com o servidor conectado, é liberada na cidade.
Campo
O que faz
Padrão
Cargo de quem foi liberado
O acesso à cidade
Nenhum (obrigatório com a whitelist ativa)
Cargo a remover
Opcional. O bot tira esse cargo de quem é liberado (um cargo de “não liberado”, por exemplo)
Nenhum
Formato do apelido
O apelido que o bot coloca. Digite / para inserir {personagem}, {id} ou {nome}. Até 60 caracteres; o apelido final é cortado em 32. Não funciona com o dono do servidor nem com cargos acima do bot
{personagem} | {id}
Mensagem
Aparece para a pessoa assim que o ID é liberado, com o ID e o apelido embaixo
“Tudo pronto, {membro}! Seu ID foi liberado em {servidor}. Bom jogo!”
Exemplo: com o formato padrão, o personagem “Carlos Andrade” e o ID 1234, o apelido vira Carlos Andrade | 1234.
Com o recurso fivedash instalado e o servidor conectado, o cartão Na cidade mostra Servidor conectado e a liberação também libera o ID no jogo. Sem conexão, a whitelist fica só no Discord (cargos e apelido).
Campo
O que faz
Padrão
Tirar a whitelist de quem for expulso ou banido
Expulso ou banido do Discord (pelo /kick, pelo /ban, pela proteção ou à mão), perde a whitelist na cidade e, se estiver jogando, é desconectado
Ligado
Tirar a whitelist de quem sair do Discord
Qualquer saída do servidor do Discord, até por conta própria, tira a whitelist na cidade e desconecta quem estiver jogando
Ligado
O que a pessoa manda na liberação depende da framework da cidade, que o recurso detecta sozinho:
Framework
O que a pessoa informa
Creative Network Enchanted
O ID do jogo (Seu ID no jogo) ou, se a cidade libera por token, o token (Seu token do jogo)
vRP / vRPex
O ID do jogo
QBCore, Qbox, ESX (esx_whitelist)
Nada além do nome do personagem: a cidade encontra a pessoa pelo Discord. Ela precisa tentar entrar no servidor uma vez, com o Discord aberto, antes de liberar
ox_core
Sem whitelist pelo FiveDash ainda: a liberação continua dando o cargo no Discord
Na Visão geral, a lista Liberados mostra cada liberação com o ID, o personagem, o apelido, o status no jogo e, se for o caso, “Pulou a whitelist com o codiguinho …”. Busque por nome, personagem, ID do jogo ou codiguinho e filtre por código.
Codiguinhos deixam alguém pular a whitelist: para parceiros, sorteios ou quem a equipe quiser liberar. A pessoa digita o código num painel próprio e ganha o cargo de aprovado na hora. Existem nos modos Análise manual e Só entrevista, na aba Codiguinhos.
Posta um painel num canal só dele, com o botão para digitar o código
Desligado
Canal do painel
Onde fica o botão para usar o codiguinho
Nenhum (obrigatório com a whitelist ativa)
E a entrevista?
Só em Análise manual com entrevista. Pula a entrevista: ganha o cargo de aprovado na hora. Vai para a entrevista: entra na fila, como quem teve as respostas aprovadas
Pula a entrevista
Título, texto, botão e imagem
Textos do painel e da resposta Aceito
Título “Codiguinho”, botão “Usar codiguinho”
O codiguinho sempre pula as perguntas. Em Só entrevista, ele pula a entrevista também.
Na lista Códigos, busque por código ou nota e filtre por Ativos, Esgotados, Expirados ou Desativados. No menu de cada código: Copiar código, Ver quem usou, Desativar / Reativar e Excluir. Tudo isso exige Gerenciar.
Status
Significado
Ativo
Pode ser usado
Esgotado
Chegou ao limite de usos
Expirado
Passou da validade
Desativado
A equipe desativou (pode reativar)
Excluir um código tira ele da lista junto com quem usou. As liberações feitas com ele continuam marcadas.
A pessoa mandou o ID e o bot disse que ele não existe na cidade. E agora?
A cidade não encontrou esse ID. A pessoa precisa entrar no servidor uma vez, conferir o ID que aparece e tentar de novo. Em QBCore, Qbox e ESX, ela precisa tentar entrar com o Discord aberto no computador antes de liberar.
O bot não deu o cargo de acesso. Por quê?
O cargo do bot está abaixo do cargo que ele tenta dar. Em Configurações do servidor → Cargos no Discord, arraste o cargo do bot para cima dos cargos da whitelist.
Posso liberar alguém sem whitelist?
Sim. Use /liberar no Discord (equipe com os cargos em Cargos que podem usar) ou gere um codiguinho nos modos Análise manual e Só entrevista.
O que acontece se o servidor FiveM estiver desligado na hora da liberação?
A pessoa ganha o cargo no Discord normalmente, e a liberação fica Na fila. O ID é liberado na cidade assim que o servidor voltar.
Quanto tempo a pessoa espera para tentar de novo?
O tempo de Tentar de novo (padrão: 30 min). O bot mostra quando ela pode tentar.