Het whitelistsysteem van ADN

ADN's Whitelist Systeem – Geavanceerde Toegangscontrole voor FiveM Servers

Het Whitelist Systeem van ADN biedt uitgebreid servertoegangsbeheer dat veel verder gaat dan eenvoudige Discord-rolcontroles. Deze whitelisting-oplossing van bedrijfsniveau geeft u gedetailleerde controle over wie uw server kan joinen, tot welke banen ze toegang hebben, welke functies ze kunnen gebruiken en hoe hun permissies evolueren naarmate ze vorderen in uw community. Of u nu een kleine privéserver voor vrienden runt of een whitelisted roleplay-community met meer dan 200 spelers beheert, dit systeem schaalt om aan uw toegangsbeheerbehoeften te voldoen, terwijl het eenvoudig te configureren en te beheren blijft.

Wat dit onderscheidt van basale whitelist-scripts is de diepte van integratie en flexibiliteit. In plaats van alleen “gewhitelist” of “niet-gewhitelist”, kunt u gelaagde toegangsniveaus creëren, op rollen gebaseerd baan permissies, tijdgebonden ontgrendelingen van functies, automatisering van sollicitatieprocessen en zelfs tijdelijke toegangsverleningen voor proefperiodes. Het systeem maakt verbinding met Discord voor authenticatie, integreert met uw database voor persistentie en biedt zowel in-game als externe beheerhulpmiddelen, zodat u de toegang vanaf elke locatie kunt beheren. Het is de complete toegangsbeheer infrastructuur die serieuze roleplay gemeenschappen nodig hebben.

Wat is inbegrepen

U ontvangt het complete whitelist-systeem met Discord bot-integratie, database-schema, server-side permissie-checking, client-side UI componenten, een admin-beheerpaneel en uitgebreide configuratiebestanden. Het pakket bevat vooraf gebouwde workflows voor applicatiebeoordeling, geautomatiseerde rol-synchronisatie, multi-tier permissie-structuren en logsystemen die alle toegangsveranderingen bijhouden voor auditdoeleinden. Alles is gebouwd op veilige authenticatieprincipes met encryptie, anti-spoofing maatregelen en failsafe-logica die spelers kickt als de verificatie mislukt, in plaats van ongeautoriseerde toegang toe te staan.

Core Whitelist Features

• Discord Integratie – Automatische authenticatie via Discord met rol synchronisatie, zodat alleen goedgekeurde communityleden uw server kunnen joinen
• Toegangsniveaus met meerdere niveaus – Creëer onbeperkte permissieniveaus (bezoeker, burger, vertrouwd, VIP, personeel, etc.) met verschillende mogelijkheden voor elk niveau
• Op banen gebaseerde whitelisting – Beheer toegang tot specifieke banen en facties (politie, EMS, bendes, bedrijven) met aparte goedkeuringsworkflows
• Applicatiesysteem – Ingebouwde aanvraagformulieren met aangepaste vragen, toewijzing van beoordelaars, goedkeurings-/afkeuringsworkflows en meldingssystemen
• Tijdelijke Toegang – Verleen tijdelijke whitelist-status voor proefleden, speciale evenementen of proefperiodes met automatische vervaldatum
• Dynamische Permissie Updates – Wijzigingen in Discord-rollen of whitelist-status worden direct toegepast zonder dat de speler opnieuw hoeft te verbinden
• Wachtrij Prioriteit Integratie – Compatibel met connection queue systemen om whitelisted spelers prioriteit servertoegang te geven
• Backup Authenticatie – Fallback-authenticatiemethoden zorgen voor systeembetrouwbaarheid, zelfs als Discord API problemen heeft

Geavanceerde Beheermogelijkheden

• Web-gebaseerd Admin Paneel – Beheer whitelists, beoordeel aanvragen, pas permissies aan en bekijk logs vanaf elk apparaat met een webbrowser
• In-Game Admin Commando's – Serverpersoneel kan whitelist-status verlenen/intrekken, spelersrechten controleren en toegangslogboeken bekijken zonder het spel te verlaten
• Bulk Beheerhulpmiddelen – Voeg grote groepen spelers tegelijk toe of verwijder ze, handig voor factiewerving of het opschonen van inactieve accounts
• Geautomatiseerde Rol Synchronisatie – Discord rolwijzigingen updaten automatisch in-game permissies op basis van uw geconfigureerde mappingregels
• Audit Logging – Volledige logs van wie wie heeft whitelisted, wanneer, en voor welke rollen met doorzoekbare geschiedenis en exportmogelijkheden
• Notificatiesystemen – Geautomatiseerde Discord berichten voor updates van de aanvraagstatus, whitelist toekenningen, verlengingen en intrekkingen
• Aangepaste Velden – Voeg server-specifieke gegevensverzameling toe aan whitelist-aanvragen (achtergronden van personages, eerdere RP ervaring, etc.)
• Beroepsprocedure – Ingebouwd systeem voor afgewezen sollicitanten om beslissingen aan te vechten met aparte beoordelingswachtrijen

Hoe het werkt

Wanneer een speler probeert verbinding te maken met uw server, onderschept het systeem de verbinding en start de authenticatie. Het controleert hun Discord-account tegen de ledenlijst van uw server en verifieert dat ze de vereiste rollen hebben voor basis servertoegang. Als ze deze eerste controle doorstaan, bevraagt het systeem de database voor hun specifieke whitelist-status – voor welke banen ze zijn goedgekeurd, welke permissie-tier ze hebben en of er tijdelijke beperkingen van toepassing zijn. Dit alles gebeurt in milliseconden tijdens de normale verbindingshandshake.

Eenmaal in-game, monitort het whitelist systeem continu de spelerspermissies. Als een medewerker de politie whitelist van iemand verwijdert via het admin paneel, wordt die wijziging onmiddellijk doorgevoerd en verliest de speler in realtime de toegang tot politie functies. Als iemand solliciteert voor een baan en wordt goedgekeurd, ontvangen ze een Discord melding en kunnen ze onmiddellijk de nieuw toegekende rol benaderen zonder opnieuw te verbinden. Dit live permissie systeem elimineert het “relog om permissies bij te werken” probleem dat eenvoudigere whitelist scripts teistert.

Sollicitatie Workflow

Spelers dienen whitelist-aanvragen in via Discord-commando's, een webportaal of in-game UI, afhankelijk van uw configuratie. Aanvragen worden doorgestuurd naar aangewezen beoordelaars op basis van wat wordt aangevraagd – burger whitelist-aanvragen gaan naar algemeen personeel, politieaanvragen gaan naar PD-commando, bedrijfsaanvragen gaan naar bedrijfsbeheerders, etc. Beoordelaars zien alle ingediende informatie, kunnen aanvullende details opvragen, de spelersgeschiedenis controleren en goedkeuren/afkeuren met aanpasbare berichten.

Het systeem houdt de sollicitatiegeschiedenis bij, toont hoe vaak iemand heeft gesolliciteerd, eerdere afwijzingsredenen en opmerkingen van beoordelaars. Dit voorkomt dat dezelfde problematische sollicitant herhaaldelijk solliciteert tijdens verschillende diensten van het personeel. Goedgekeurde sollicitaties werken automatisch de database bij, wijzen Discord rollen toe, sturen bevestigingsberichten en loggen de transactie voor auditdoeleinden.

Installatie

1. Stel de Discord bot in met de meegeleverde bot token en configureer deze met uw Discord server ID en rol ID's
2. Importeer het databaseschema in de MySQL database van je server met behulp van het meegeleverde SQL bestand
3. Configureer de hoofd config.lua bestand met uw Discord-instellingen, databasegegevens en permissie-tiers
4. Stel het webpaneel (optioneel) in op uw webserver met de meegeleverde PHP/Node.js bestanden
5. Voeg de bron toe aan uw server.cfg en start je server opnieuw op
6. Test het systeem door in te loggen met een Discord-account en te verifiëren dat de authenticatie correct werkt
7. Configureer uw eerste permissietiers en job whitelists in het adminpaneel

Configuratieopties

• Discord Instellingen – Bot token, server ID, roltoewijzingen, notificatiekanalen en webhook configuraties
• Permissieniveaus – Definieer tier-namen, vereiste Discord-rollen, in-game mogelijkheden en prioriteitsniveaus
• Job Whitelist Regels – Configureer welke banen whitelist goedkeuring vereisen versus open toegang, goedkeuringsworkflows en beperkingen
• Aanvraagformulieren – Pas vragen, verplichte velden, tekenlimieten en bijlageopties aan voor verschillende sollicitatietypes
• Authenticatiemethoden – Primaire Discord-authenticatie plus back-upmethoden zoals licentie-identificaties of IP-gebaseerde herkenning
• Tijdelijke Toegang – Stel standaard vervaltijden, vernieuwingsprocessen en geautomatiseerde verwijderingsprocedures in
• Wachtrij Integratie – Maak verbinding met populaire wachtrijbronnen om spelers met een whitelist verbindingsprioriteit te geven
• Notificatie Voorkeuren – Bepaal welke gebeurtenissen Discord-berichten activeren, wie ze ontvangt en de opmaak van de berichten

Framework-compatibiliteit

• ESX Legacy – Volledige integratie met ESX jobsysteem, databasestructuur en permissieframeworks
• ESX 1.9.x – Compatibel met oudere ESX versies met automatische aanpassing van het databaseschema
• QBCore – Native ondersteuning voor QBCore-taakbeheer, permissiecontrole en commandostructuren
• QBOX – Werkt met QBOX framework architectuur en permissiesystemen
• Standalone – Kan worden aangepast voor aangepaste frameworks met exports en gebeurtenisgebaseerde integratie

Wat het onderscheidt

De meeste whitelist-scripts zijn eenvoudige systemen die controleren of de Discord-rol bestaat, zonder nuance. Het Whitelist Systeem van ADN biedt toegangscontrole op ondernemingsniveau die kan wedijveren met commerciële serverbeheerplatforms. Alleen al de workflowautomatisering van de aanvraag bespaart honderden beheerdersuren op grote servers – geen handmatige tracking meer van spreadsheets met aanvragers of het kopiëren en plakken van Discord-ID's in databasetabellen. Het meerlaagse permissiesysteem maakt geleidelijke gemeenschaps­toegang mogelijk in plaats van een binaire ja/nee, waardoor progressiepaden ontstaan die de retentie van spelers verbeteren.

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.

Beveiligingsfuncties

• Anti-Spoofing – Meerdere verificatielagen voorkomen dat spelers Discord identiteiten vervalsen of authenticatie omzeilen
• Versleutelde Communicatie – Gevoelige gegevens die worden verzonden tussen de gameserver en Discord gebruiken versleutelde kanalen
• Snelheidsbeperking – Bescherming tegen spam-aanvragen of brute force authenticatiepogingen
• Failsafe Logica – Als authenticatie niet kan worden geverifieerd (Discord uitgevallen, database onbereikbaar), worden spelers geweigerd in plaats van toegelaten
• Sessie Validatie – Continue verificatie tijdens gameplay voorkomt sessiekaping of exploits van permissies midden in het spel
• IP-tracking – Optionele IP-logging voor beveiligingsanalyse en detectie van ban-evasion

Veelvoorkomende Implementatiescenario's

Nieuwe servers beginnen met een basis burger whitelist die alleen Discord lidmaatschap en een eenvoudige aanvraag vereist. Naarmate de community groeit, voegen ze job whitelists toe voor politie, EMS en bedrijven. Gevestigde servers gebruiken multi-tier systemen met “trusted” status die eigendom van onroerend goed ontgrendelt, “VIP” status die wachtrijprioriteit biedt, en “staff” tiers die admin-mogelijkheden bieden. Grote communities delegeren whitelist goedkeuring – gangleiders keuren hun rekruten goed, PD high command behandelt sollicitaties van agenten, bedrijfseigenaren screenen werknemers.

Spelerervaring

Vanuit het perspectief van de speler is het aanvraagproces eenvoudig – formulier indienen, wachten op beoordeling, melding van goedkeuring ontvangen. De Discord-integratie betekent dat ze hun bestaande community-account gebruiken in plaats van aparte game-accounts aan te maken. Goedgekeurde spelers waarderen de wachtrijprioriteit en weten dat de whitelist-vereiste problematische spelers filtert. De transparantie van het systeem (het controleren van uw eigen whitelist-status via commando's) vermindert de verwarring over waarom u geen toegang heeft tot bepaalde banen.

Administratieve Voordelen

Servereigenaren krijgen gecentraliseerde controle over community-toegang zonder dat ze handmatig database-tabellen hoeven te bewerken of servers opnieuw hoeven op te starten voor permissiewijzigingen. Het sollicitatiesysteem creëert een papieren spoor voor alle toegangsverleningen – cruciaal voor het oplossen van geschillen over wie problematische spelers heeft goedgekeurd. De gelaagde structuur maakt geleidelijke vertrouwensniveaus mogelijk in plaats van alles-of-niets-toegang. En de automatisering vermindert de administratieve werklast dramatisch in vergelijking met handmatig whitelist-beheer.

Mogelijkheden voor aanpassing

Het modulaire ontwerp van het systeem ondersteunt uitgebreide aanpassingen. Voeg aangepaste aanvraagvragen toe die specifiek zijn voor de lore van uw server, integreer met karaktercreatiesystemen voor automatische goedkeuring van achtergrondverhalen, maak verbinding met donatiesystemen voor automatische VIP whitelist-toekenningen, of bouw aangepaste permissietiers voor server-specifieke functies. Het export-systeem, vergelijkbaar met API, maakt het eenvoudig om de whitelist-status te controleren vanuit andere bronnen.

Ondersteuning en Documentatie

ADNS Tech biedt uitgebreide documentatie over installatie, configuratie, veelvoorkomende scenario's en probleemoplossing. Ondersteuning is beschikbaar voor installatiehulp, integratievragen en het oplossen van technische problemen. Het systeem ontvangt regelmatig updates voor FiveM compatibiliteit, Discord API wijzigingen en beveiligingsverbeteringen. Een actieve community Discord biedt peer support en configuratie-uitwisseling.