Sistema de lista branca da ADN

Sistema de lista branca da ADN – Controle de acesso avançado para servidores FiveM

O sistema de whitelist da ADN oferece gerenciamento de acesso abrangente ao servidor, que vai muito além da simples verificação de funções no Discord. Essa solução de whitelist de nível empresarial oferece controle granular sobre quem pode entrar no seu servidor, quais funções podem acessar, quais recursos podem usar e como suas permissões evoluem à medida que progridem na sua comunidade. Seja você responsável por um pequeno servidor privado para amigos ou por uma comunidade de roleplay com mais de 200 jogadores, este sistema se adapta às suas necessidades de controle de acesso, mantendo-se simples de configurar e gerenciar.

O que separa isso dos scripts básicos de whitelist é a profundidade de integração e flexibilidade. Em vez de apenas “whitelisted” ou “não whitelisted”, você pode criar níveis de acesso escalonados, baseados em funções trabalho Permissões, desbloqueio de recursos por tempo limitado, automação do fluxo de trabalho do aplicativo e até mesmo concessões de acesso temporário para períodos de teste. O sistema se conecta ao Discord para autenticação, integra-se ao seu banco de dados para persistência e fornece ferramentas de gerenciamento tanto dentro do jogo quanto externas, para que você possa controlar o acesso de qualquer lugar. É a infraestrutura completa de gerenciamento de acesso que as comunidades de roleplay sérias precisam.

O que está incluído

Você recebe o sistema completo de lista de permissões com integração de bot do Discord, esquema de banco de dados, verificação de permissões no servidor, componentes de interface do usuário no cliente, painel de gerenciamento administrativo e arquivos de configuração abrangentes. O pacote inclui fluxos de trabalho de revisão de aplicativos pré-configurados, sincronização automática de funções, estruturas de permissão em vários níveis e sistemas de registro que rastreiam todas as alterações de acesso para fins de auditoria. Tudo é construído com base em princípios de autenticação segura, com criptografia, medidas anti-spoofing e lógica de segurança que expulsa os jogadores caso a verificação falhe, em vez de permitir o acesso não autorizado.

Principais funcionalidades da lista branca

• Integração Discord – Autenticação automática via Discord com sincronização de funções, garantindo que apenas membros aprovados da comunidade possam entrar no seu servidor.
• Níveis de acesso em vários níveis – Crie níveis de permissão ilimitados (visitante, civil, confiável, VIP, funcionário, etc.) com diferentes capacidades para cada nível.
• Lista branca baseada em emprego – Controlar o acesso a empregos e facções específicos (polícia, EMS, gangues, empresas) com fluxos de trabalho de aprovação separados
• Sistema de Aplicação – Formulários de inscrição integrados com perguntas personalizadas, atribuição de avaliadores, fluxos de trabalho de aprovação/rejeição e sistemas de notificação.
• Acesso temporário – Conceder status de lista branca por tempo limitado para membros em período de teste, eventos especiais ou períodos probatórios com expiração automática.
• Atualizações dinâmicas de permissões – Alterações nas funções do Discord ou no status da lista de permissões são aplicadas instantaneamente, sem exigir que o jogador se reconecte.
• Integração de prioridade de fila – Compatível com sistemas de fila de conexão para dar acesso prioritário ao servidor a jogadores autorizados.
• Autenticação de backup – Os métodos de autenticação alternativos garantem a confiabilidade do sistema mesmo que a API do Discord apresente problemas.

Capacidades avançadas de gestão

• Painel de administração baseado na Web – Gerencie listas de permissões, revise aplicativos, ajuste permissões e visualize registros de qualquer dispositivo com um navegador da web.
• Comandos de administrador no jogo – A equipe do servidor pode conceder/revogar o status de whitelist, verificar as permissões dos jogadores e revisar os registros de acesso sem sair do jogo.
• Ferramentas de gerenciamento em massa – Adicione ou remova grandes grupos de jogadores simultaneamente, útil para recrutamento de facções ou para eliminar contas inativas.
• Sincronização automática de funções – As alterações de função no Discord atualizam automaticamente as permissões no jogo com base nas regras de mapeamento configuradas.
• Registro de auditoria – Registros completos de quem adicionou quem à lista de permissões, quando e para quais funções, com histórico pesquisável e recursos de exportação.
• Sistemas de Notificação – Mensagens automatizadas no Discord para atualizações sobre o status de aplicativos, concessões de permissões, expirações e revogações.
• Campos personalizados – Adicionar coleta de dados específicos do servidor para permitir aplicativos na lista de permissões (histórias de personagens, experiência anterior em RPG, etc.)
• Processo de Apelação – Sistema integrado para que os candidatos com pedidos negados possam recorrer das decisões, com filas de revisão separadas.

Como funciona

Quando um jogador tenta entrar no seu servidor, o sistema intercepta a conexão e inicia a autenticação. Ele verifica a conta do Discord do jogador na lista de membros do servidor e confirma se ele possui as funções necessárias para o acesso básico. Se ele passar nessa primeira verificação, o sistema consulta o banco de dados para verificar o status específico dele na lista de permissões — para quais funções ele está aprovado, qual o nível de permissão que ele possui e se alguma restrição temporária se aplica. Tudo isso acontece em milissegundos durante o handshake de conexão normal.

Uma vez no jogo, o sistema de whitelist monitora continuamente as permissões dos jogadores. Se um membro da equipe remover o whitelist da polícia de alguém via painel de administração, essa alteração é propagada imediatamente e o jogador perde o acesso às funções do trabalho policial em tempo real. Se alguém se candidatar a um emprego e for aprovado, recebe uma notificação Discord e pode acessar imediatamente o papel recém-concedido sem reconectar. Este sistema de permissão ao vivo elimina o problema de “relogar para atualizar permissões” que aflige scripts de whitelist mais simples.

Fluxo de trabalho do aplicativo

Os jogadores enviam solicitações para a lista branca por meio de comandos do Discord, um portal da web ou a interface do jogo, dependendo da sua configuração. As solicitações são encaminhadas para os revisores designados com base no que foi solicitado: solicitações de civis vão para a equipe geral, solicitações policiais vão para o comando da polícia, solicitações comerciais vão para os administradores comerciais, etc. Os revisores visualizam todas as informações enviadas, podem solicitar detalhes adicionais, verificar o histórico do jogador e aprovar/rejeitar a solicitação com mensagens personalizáveis.

O sistema rastreia o histórico de candidaturas, mostrando quantas vezes alguém se candidatou, os motivos de recusas anteriores e as observações do avaliador. Isso impede que o mesmo candidato problemático se candidate repetidamente em diferentes turnos da equipe. As candidaturas aprovadas atualizam automaticamente o banco de dados, atribuem funções no Discord, enviam mensagens de confirmação e registram a transação para fins de auditoria.

Instalação

1. Configure o bot do Discord usando o token fornecido e assine-o com o ID do seu servidor e os IDs das suas funções no Discord.
2. Importe o esquema do banco de dados para o banco de dados MySQL do seu servidor usando o arquivo SQL fornecido.
3. Configure o principal config.lua Arquivo com suas configurações do Discord, credenciais do banco de dados e níveis de permissão.
4. Configure o painel web (opcional) em seu servidor web com os arquivos PHP/Node.js incluídos.
5. Adicione o recurso ao seu server.cfg e reinicie o servidor.
6. Teste o sistema entrando com uma conta do Discord e verificando se a autenticação funciona corretamente.
7. Configure seus primeiros níveis de permissão e listas de permissões de tarefas no painel de administração.

Opções de configuração

• Configurações do Discord – Token do bot, ID do servidor, mapeamento de funções, canais de notificação e configurações de webhook
• Níveis de permissão – Defina os nomes dos níveis, as funções necessárias no Discord, as capacidades no jogo e os níveis de prioridade.
• Regras da lista branca de empregos – Configure quais tarefas exigem aprovação por meio de lista de permissões e quais têm acesso aberto, fluxos de trabalho de aprovação e restrições.
• Formulários de inscrição – Personalize perguntas, campos obrigatórios, limites de caracteres e opções de anexos para diferentes tipos de inscrição.
• Métodos de autenticação – Autenticação primária do Discord, além de métodos de backup como identificadores de licença ou reconhecimento baseado em IP.
• Acesso temporário – Defina os tempos de expiração padrão, os processos de renovação e os procedimentos de remoção automática.
• Integração de filas – Conecte-se a recursos de fila populares para dar prioridade de conexão aos jogadores na lista de permissões.
• Preferências de notificação – Controle quais eventos acionam mensagens do Discord, quem as recebe e a formatação das mensagens.

Compatibilidade de Framework

• ESX Legado – Integração completa com o sistema de tarefas ESX, estrutura de banco de dados e sistemas de permissões.
• ESX 1.9.x – Compatível com versões mais antigas do ESX com adaptação automática do esquema do banco de dados.
• QBCore – Suporte nativo para gerenciamento de tarefas, verificação de permissões e estruturas de comando do QBCore.
• QBOX – Funciona com a arquitetura do framework QBOX e sistemas de permissões.
• Standalone – Pode ser adaptado para estruturas personalizadas com exportações e integração baseada em eventos.

O que o torna especial

A maioria dos scripts de whitelist são sistemas simples de “verificar se o papel Discord existe” sem nuances. O Sistema de Whitelist da ADN fornece controle de acesso de nível empresarial que rivaliza com plataformas comerciais de gerenciamento de servidores. O fluxo de trabalho de automação de aplicativos sozinho economiza centenas de horas de administradores em servidores grandes – não é mais necessário rastrear manualmente planilhas de candidatos ou copiar e colar IDs Discord em tabelas de banco de dados. O sistema de permissões em múltiplos níveis permite acesso gradual à comunidade em vez de sim/não binário, criando caminhos de progressão que melhoram a retenção de jogadores.

As atualizações de permissão ao vivo mudam o jogo para a administração. Demitir um policial por corrupção? Remova sua whitelist instantaneamente e eles perdem o acesso ao distintivo imediatamente. Promover um jogador à liderança de gangue? Conceda permissões elevadas em tempo real. Chega de mensagens de “relogar para atualizar”, sem reinicializações de servidor para aplicar as alterações. E o registro abrangente significa que você sempre sabe quem autorizou o quê, quando, e pode rastrear quaisquer problemas de acesso até sua origem.

Recursos de segurança

• Anti-falsificação – Múltiplas camadas de verificação impedem que jogadores falsifiquem identidades no Discord ou burlem a autenticação.
• Comunicação criptografada – Os dados sensíveis transmitidos entre o servidor do jogo e o Discord utilizam canais criptografados.
• Limitação de taxa – Proteção contra aplicativos de spam ou tentativas de autenticação por força bruta
• Lógica à prova de falhas – Se a autenticação não puder ser verificada (Discord fora do ar, banco de dados inacessível), os jogadores serão impedidos de entrar, em vez de serem permitidos.
• Validação de sessão – A verificação contínua durante o jogo impede o sequestro da sessão ou a exploração de permissões durante a partida.
• Rastreamento de IP – Registro opcional de IP para análise de segurança e detecção de evasão de bloqueio

Cenários comuns de implantação

Novos servidores começam com uma lista branca civil básica que requer apenas a filiação Discord e um simples pedido. À medida que a comunidade cresce, eles adicionam listas brancas de empregos para a polícia, EMS e negócios. Servidores estabelecidos usam sistemas de múltiplos níveis com status “confiável” desbloqueando a propriedade, status “VIP” oferecendo prioridade na fila e níveis “staff” fornecendo capacidades de administração. Grandes comunidades delegam a aprovação da lista branca – líderes de gangues aprovam seus recrutas, o alto comando da PD lida com os pedidos de oficiais, os donos de negócios aprovam os funcionários.

Experiência do jogador

Do ponto de vista do jogador, o processo de inscrição é simples: enviar o formulário, aguardar a análise e receber a notificação de aprovação. A integração com o Discord permite que eles usem sua conta da comunidade existente em vez de criar contas de jogo separadas. Jogadores aprovados apreciam a prioridade na fila e sabem que o requisito da lista de permissões filtra jogadores problemáticos. A transparência do sistema (verificar seu próprio status na lista de permissões por meio de comandos) reduz a confusão sobre por que você não pode acessar determinadas classes.

Benefícios Administrativos

Os proprietários de servidores obtêm controle centralizado sobre o acesso da comunidade sem precisar editar manualmente tabelas de banco de dados ou reiniciar servidores para alterações de permissões. O sistema de aplicação cria um registro de todas as concessões de acesso — crucial para resolver disputas sobre quem aprovou jogadores problemáticos. A estrutura hierárquica permite níveis de confiança graduais, em vez de acesso total ou nenhum. E a automação reduz drasticamente a carga de trabalho administrativa em comparação com o gerenciamento manual de listas de permissão.

Possibilidades de personalização

O design modular do sistema permite ampla personalização. Adicione perguntas de inscrição personalizadas específicas para a história do seu servidor, integre-o com sistemas de criação de personagens para aprovação automática de histórico, conecte-o a sistemas de doação para concessão automática de permissões VIP ou crie níveis de permissão personalizados para recursos específicos do servidor. O sistema de exportação semelhante a uma API facilita a verificação do status da lista de permissões a partir de outras fontes.

Suporte e Documentação

A ADNS Tech oferece documentação completa sobre instalação, configuração, cenários comuns e solução de problemas. O suporte está disponível para auxiliar na configuração, esclarecer dúvidas sobre integração e resolver problemas técnicos. O sistema recebe atualizações regulares para compatibilidade com FiveM, alterações na API do Discord e melhorias de segurança. A comunidade ativa no Discord oferece suporte entre usuários e compartilhamento de configurações.