ADN’s Whitelist System

ADN's Whitelist System - Advanced Access Control for FiveM Servers

ADN's Whitelist System provides comprehensive server access management that goes far beyond simple Discord role checking. This enterprise-grade whitelisting solution gives you granular control over who can join your server, which jobs they can access, which features they can use, and how their permissions evolve as they progress through your community. Whether you're running a small private server for friends or managing a 200+ player whitelisted roleplay community, this system scales to meet your access control needs while remaining simple to configure and manage.

What separates this from basic whitelist scripts is the depth of integration and flexibility. Instead of just whitelisted or not whitelisted, you can create tiered access levels, role-based job permissions, time-gated feature unlocks, application workflow automation, and even temporary access grants for trial periods. The system connects to Discord for authentication, integrates with your database for persistence, and provides both in-game and external management tools so you can control access from anywhere. It's the complete access management infrastructure serious roleplay communities need.

What's Included

You receive the complete whitelist system with Discord bot integration, database schema, server-side permission checking, client-side UI components, admin management panel, and extensive configuration files. The package includes pre-built application review workflows, automated role synchronization, multi-tier permission structures, and logging systems that track all access changes for audit purposes. Everything is built on secure authentication principles with encryption, anti-spoofing measures, and failsafe logic that kicks players if verification fails rather than allowing unauthorized access.

Core Whitelist Features

• Discord Integration - Automatic authentication via Discord with role synchronization, ensuring only approved community members can join your server
• Multi-Tier Access Levels - Create unlimited permission tiers (visitor, civilian, trusted, VIP, staff, etc.) with different capabilities for each level
• Job-Based Whitelisting - Control access to specific jobs and factions (police, EMS, gangs, businesses) with separate approval workflows
• Application System - Built-in application forms with custom questions, reviewer assignments, approval/denial workflows, and notification systems
• Temporary Access - Grant time-limited whitelist status for trial members, special events, or probationary periods with automatic expiration
• Dynamic Permission Updates - Changes to Discord roles or whitelist status apply instantly without requiring player reconnection
• Queue Priority Integration - Compatible with connection queue systems to give whitelisted players priority server access
• Backup Authentication - Fallback authentication methods ensure system reliability even if Discord API has issues

Advanced Management Capabilities

• Web-Based Admin Panel - Manage whitelists, review applications, adjust permissions, and view logs from any device with a web browser
• In-Game Admin Commands - Server staff can grant/revoke whitelist status, check player permissions, and review access logs without leaving the game
• Bulk Management Tools - Add or remove large groups of players simultaneously, useful for faction recruitment or purging inactive accounts
• Automated Role Sync - Discord role changes automatically update in-game permissions based on your configured mapping rules
• Audit Logging - Complete logs of who whitelisted whom, when, and for what roles with searchable history and export capabilities
• Notification Systems - Automated Discord messages for application status updates, whitelist grants, expirations, and revocations
• Custom Fields - Add server-specific data collection to whitelist applications (character backstories, previous RP experience, etc.)
• Appeal Process - Built-in system for denied applicants to appeal decisions with separate review queues

Perfect For

• Serious roleplay servers requiring application-based community entry and character approval
• Whitelisted job factions that need separate approval processes (police academy, gang recruitment, etc.)
• Private servers for communities, friend groups, or content creators wanting controlled access
• Servers transitioning from public to whitelisted and needing migration tools for existing players
• Large communities with multiple staff tiers needing delegated whitelist management capabilities
• Servers hosting special events requiring temporary access grants for participants

How It Works

When a player attempts to join your server, the system intercepts the connection and initiates authentication. It checks their Discord account against your server's member list and verifies they have the required roles for basic server access. If they pass this first check, the system queries the database for their specific whitelist status - which jobs they're approved for, what permission tier they hold, and whether any temporary restrictions apply. All of this happens in milliseconds during the normal connection handshake.

Once in-game, the whitelist system continuously monitors player permissions. If a staff member removes someone's police whitelist via the admin panel, that change propagates immediately and the player loses access to police job functions in real-time. If someone applies for a job and gets approved, they receive a Discord notification and can immediately access the newly granted role without reconnecting. This live permission system eliminates the relog to update permissions problem that plagues simpler whitelist scripts.

Application Workflow

Players submit whitelist applications either through Discord commands, a web portal, or in-game UI depending on your configuration. Applications route to designated reviewers based on what's being requested - civilian whitelist apps go to general staff, police applications route to PD command, business applications go to business admins, etc. Reviewers see all submitted information, can request additional details, check player history, and approve/deny with customizable messages.

The system tracks application history, showing how many times someone has applied, previous denial reasons, and reviewer notes. This prevents the same problematic applicant from repeatedly applying across different staff shifts. Approved applications automatically update the database, assign Discord roles, send confirmation messages, and log the transaction for audit purposes.

Installation

1. Set up the Discord bot using the provided bot token and configure it with your Discord server ID and role IDs
2. Import the database schema into your server's MySQL database using the provided SQL file
3. Configure the main config.lua file with your Discord settings, database credentials, and permission tiers
4. Set up the web panel (optional) on your web server with the included PHP/Node.js files
5. Add the resource to your server.cfg and restart your server
6. Test the system by joining with a Discord account and verifying authentication works correctly
7. Configure your first permission tiers and job whitelists in the admin panel

Configuration Options

• Discord Settings - Bot token, server ID, role mappings, notification channels, and webhook configurations
• Permission Tiers - Define tier names, required Discord roles, in-game capabilities, and priority levels
• Job Whitelist Rules - Configure which jobs require whitelist approval vs. open access, approval workflows, and restrictions
• Application Forms - Customize questions, required fields, character limits, and attachment options for different application types
• Authentication Methods - Primary Discord auth plus backup methods like license identifiers or IP-based recognition
• Temporary Access - Set default expiration times, renewal processes, and automated removal procedures
• Queue Integration - Connect with popular queue resources to give whitelisted players connection priority
• Notification Preferences - Control what events trigger Discord messages, who receives them, and message formatting

Framework Compatibility

• ✅ ESX Legacy - Full integration with ESX job system, database structure, and permission frameworks
• ✅ ESX 1.9.x - Compatible with older ESX versions with automatic database schema adaptation
• ✅ QBCore - Native support for QBCore job management, permission checking, and command structures
• ✅ QBOX - Works with QBOX framework architecture and permission systems
• ✅ Standalone - Can be adapted for custom frameworks with exports and event-based integration

What Makes It Stand Out

Most whitelist scripts are simple check if Discord role exists systems with no nuance. ADN's Whitelist System provides enterprise-level access control that rivals commercial server management platforms. The application workflow automation alone saves hundreds of admin hours on large servers - no more manually tracking spreadsheets of applicants or copy-pasting Discord IDs into database tables. The multi-tier permission system allows graduated community access rather than binary yes/no, creating progression paths that improve player retention.

The live permission updates are game-changing for administration. Fire a cop for corruption? Remove their whitelist instantly and they lose badge access immediately. Promote a player to gang leadership? Grant elevated permissions in real-time. No more relog to update messages, no server restarts to apply changes. And the comprehensive logging means you always know who authorized what, when, and can trace any access issues back to their source.

Security Features

• Anti-Spoofing - Multiple verification layers prevent players from faking Discord identities or bypassing authentication
• Encrypted Communication - Sensitive data transmitted between game server and Discord uses encrypted channels
• Rate Limiting - Protection against spam applications or brute force authentication attempts
• Failsafe Logic - If authentication cannot be verified (Discord down, database unreachable), players are denied rather than allowed
• Session Validation - Continuous verification during gameplay prevents session hijacking or mid-game permission exploits
• IP Tracking - Optional IP logging for security analysis and ban evasion detection

Common Deployment Scenarios

New servers start with basic civilian whitelist requiring only Discord membership and simple application. As the community grows, they add job whitelists for police, EMS, and businesses. Established servers use multi-tier systems with trusted status unlocking property ownership, VIP status offering queue priority, and staff tiers providing admin capabilities. Large communities delegate whitelist approval - gang leaders approve their recruits, PD high command handles officer applications, business owners vet employees.

Player Experience

From a player perspective, the application process is straightforward - submit form, wait for review, get notification of approval. The Discord integration means they use their existing community account rather than creating separate game accounts. Approved players appreciate the queue priority and know the whitelist requirement filters out problematic players. The system's transparency (checking your own whitelist status via commands) reduces confusion about why you can't access certain jobs.

Administrative Benefits

Server owners gain centralized control over community access without needing to manually edit database tables or restart servers for permission changes. The application system creates a paper trail for all access grants - crucial for resolving disputes about who approved problematic players. The tiered structure allows graduated trust levels rather than all-or-nothing access. And the automation reduces admin workload dramatically compared to manual whitelist management.

Customization Possibilities

The system's modular design supports extensive customization. Add custom application questions specific to your server lore, integrate with character creation systems for automatic backstory approval, connect to donation systems for automatic VIP whitelist grants, or build custom permission tiers for server-specific features. The API-like export system makes it easy to check whitelist status from other resources.

Support and Documentation

ADNS Tech provides comprehensive documentation covering installation, configuration, common scenarios, and troubleshooting. Support is available for setup assistance, integration questions, and resolving technical issues. The system receives regular updates for FiveM compatibility, Discord API changes, and security improvements. Active community Discord offers peer support and configuration sharing.

Related Admin Tools & More

• Staff Portal (Web Panel) - Warn, Kick, Ban, Command
• ESX Admin Tool / Player Manager (+ Discord Integration)
• WX AntiCheat
• Anti CombatLog