ADNs Whitelist-System

ADNs Whitelist-System – Erweiterte Zugriffskontrolle für FiveM-Server

ADNs Whitelist-System bietet ein umfassendes Serverzugriffsmanagement, das weit über einfache Discord-Rollenprüfungen hinausgeht. Diese enterprise-grade Whitelisting-Lösung gibt dir eine granularen Kontrolle darüber, wer deinen Server betreten kann, welche Jobs sie zugreifen können, welche Funktionen sie nutzen können und wie sich ihre Berechtigungen entwickeln, wenn sie sich in deiner Community weiterentwickeln. Egal, ob du einen kleinen privaten Server für Freunde betreibst oder eine 200+-Spieler-Whitelist-Rollenspiel-Community verwaltest, dieses System skaliert, um deinen Zugriffskontrollbedürfnissen gerecht zu werden, während es einfach zu konfigurieren und zu verwalten bleibt.

Was dies von einfachen Whitelist-Skripten unterscheidet, ist die Tiefe der Integration und Flexibilität. Anstatt nur “auf der Whitelist” oder “nicht auf der Whitelist” zu sein, können Sie gestufte Zugriffsebenen und rollenbasierte Arbeit Berechtigungen, zeitgesteuerte Funktionsfreischaltungen, Antragsworkflow-Automatisierung und sogar temporäre Zugriffsgewährungen für Probebetriebszeiten. Das System verbindet sich mit Discord für die Authentifizierung, integriert sich in deine Datenbank für die Persistenz und bietet sowohl In-Game- als auch externe Verwaltungstools, damit du den Zugriff von überall steuern kannst. Es ist die vollständige Zugriffsverwaltungsinfrastruktur, die ernsthafte Rollenspielgemeinschaften benötigen.

Im Leistungsumfang enthalten

Du erhältst das vollständige Whitelist-System mit Discord-Bot-Integration, Datenbankschema, serverseitiger Berechtigungsprüfung, clientseitigen UI-Komponenten, Admin-Management-Panel und umfangreichen Konfigurationsdateien. Das Paket enthält vorab erstellte Anwendungsüberprüfungs-Workflows, automatische Rollensynchronisation, mehrstufige Berechtigungsstrukturen und Protokollierungssysteme, die alle Zugriffsänderungen für Prüfzwecke verfolgen. Alles basiert auf sicheren Authentifizierungsprinzipien mit Verschlüsselung, Anti-Spoofing-Maßnahmen und Ausfallsicherheitslogik, die Spieler bei fehlgeschlagener Verifizierung vom Server kickt, anstatt unbefugten Zugriff zu ermöglichen.

Kernfunktionen der Whitelist

• Discord-Integration – Automatische Authentifizierung über Discord mit Rollensynchronisation, die sicherstellt, dass nur genehmigte Community-Mitglieder deinen Server beitreten können
• Mehrstufige Zugriffsebenen – Erstelle unbegrenzte Berechtigungsstufen (Besucher, Zivilist, Vertrauenswürdiger, VIP, Mitarbeiter usw.) mit unterschiedlichen Fähigkeiten für jedes Level
• Jobbasiertes Whitelisting – Zugang zu bestimmten Jobs und Fraktionen kontrollieren (Polizei, Rettungsdienste, Banden, Unternehmen) mit separaten Genehmigungsabläufen
• Anwendungssystem – Integrierte Antragsformulare mit benutzerdefinierten Fragen, Zuweisung von Gutachtern, Genehmigungs-/Ablehnungs-Workflows und Benachrichtigungssystemen
• Vorübergehender Zugang – Gewährung eines zeitlich begrenzten Whitelist-Status für Testteilnehmer, besondere Ereignisse oder Probezeiten mit automatischem Ablaufdatum
• Dynamische Berechtigungsaktualisierungen – Änderungen an Discord-Rollen oder dem Whitelist-Status werden sofort wirksam, ohne dass eine erneute Verbindung des Spielers erforderlich ist.
• Warteschlangenprioritätsintegration – Kompatibel mit Verbindungswarteschlangensystemen, um Spielern auf der Whitelist priorisierten Serverzugriff zu gewähren.
• Backup-Authentifizierung – Ausweichmethoden für die Authentifizierung gewährleisten die Systemzuverlässigkeit auch dann, wenn die Discord-API Probleme aufweist.

Erweiterte Managementfunktionen

• Webbasierte Administrationskonsole – Whitelists verwalten, Anwendungen überprüfen, Berechtigungen anpassen und Protokolle von jedem Gerät mit einem Webbrowser anzeigen
• In-Game-Admin-Befehle – Servermitarbeiter können den Whitelist-Status erteilen/entziehen, Spielerberechtigungen überprüfen und Zugriffsprotokolle einsehen, ohne das Spiel zu verlassen.
• Tools zur Massenverwaltung – Gleichzeitiges Hinzufügen oder Entfernen großer Spielergruppen, nützlich für die Rekrutierung von Fraktionen oder die Bereinigung inaktiver Konten
• Automatisierte Rollensynchronisierung – Discord-Rollenänderungen aktualisieren automatisch die Ingame-Berechtigungen basierend auf deinen konfigurierten Zuordnungsregeln
• Audit-Protokollierung – Vollständige Protokolle darüber, wer wen wann für welche Rolle auf die Whitelist gesetzt hat, mit durchsuchbarem Verlauf und Exportfunktionen
• Benachrichtigungssysteme – Automatisierte Discord-Nachrichten für Statusaktualisierungen von Bewerbungen, Whitelist-Zulassungen, Ablaufdaten und Widerrufe
• Benutzerdefinierte Felder – Hinzufügen einer serverseitigen Datenerfassung zur Whitelist-Anwendung (Charakter-Hintergrundgeschichten, vorherige RP-Erfahrung usw.)
• Einspruchsverfahren – Eingebautes System für abgelehnte Antragsteller, um gegen Entscheidungen Berufung einzulegen, mit separaten Überprüfungswarteschlangen

Wie es funktioniert

Wenn ein Spieler versucht, deinem Server beizutreten, fängt das System die Verbindung ab und initiiert die Authentifizierung. Es gleicht sein Discord-Konto mit der Mitgliederliste deines Servers ab und überprüft, ob er die erforderlichen Rollen für den grundlegenden Serverzugriff besitzt. Besteht er diese erste Prüfung, fragt das System die Datenbank nach seinem spezifischen Whitelist-Status ab – für welche Aufgaben er freigegeben ist, welche Berechtigungsstufe er hat und ob temporäre Einschränkungen gelten. All dies geschieht innerhalb von Millisekunden während des normalen Verbindungsaufbaus.

Sobald das Spiel läuft, überwacht das Whitelist-System kontinuierlich die Spielerberechtigungen. Wenn ein Mitarbeiter die Polizei-Whitelist einer Person über das Admin-Panel entfernt, wird diese Änderung sofort übernommen und der Spieler verliert in Echtzeit den Zugriff auf die Polizeijobfunktionen. Wenn sich jemand für einen Job bewirbt und genehmigt wird, erhält er eine Discord-Benachrichtigung und kann sofort auf die neu gewährte Rolle zugreifen, ohne sich erneut verbinden zu müssen. Dieses Live-Berechtigungssystem eliminiert das Problem “Neuanmeldung zur Aktualisierung der Berechtigungen”, das einfachere Whitelist-Skripte plagt.

Anwendungs-Workflow

Spieler reichen ihre Anträge auf Aufnahme in die Whitelist je nach Konfiguration entweder über Discord-Befehle, ein Webportal oder die Benutzeroberfläche im Spiel ein. Die Anträge werden je nach Art des Antrags an die zuständigen Prüfer weitergeleitet: Anträge von Zivilisten gehen an das allgemeine Team, Anträge von Polizisten an die Polizeiführung, Anträge von Unternehmen an die Unternehmensadministratoren usw. Die Prüfer sehen alle eingereichten Informationen, können zusätzliche Details anfordern, die Spielerhistorie einsehen und die Anträge mit individuell anpassbaren Nachrichten genehmigen oder ablehnen.

Das System speichert den Bewerbungsverlauf und zeigt an, wie oft sich jemand beworben hat, aus welchen Gründen zuvor eine Ablehnung erfolgte und welche Anmerkungen die Prüfer hinterlassen haben. Dadurch wird verhindert, dass sich derselbe Bewerber wiederholt über verschiedene Schichten hinweg bewirbt. Genehmigte Bewerbungen werden automatisch in der Datenbank aktualisiert, Discord-Rollen zugewiesen, Bestätigungsnachrichten versendet und die Transaktion zu Prüfungszwecken protokolliert.

Installation

1. Richte den Discord-Bot mit dem bereitgestellten Bot-Token ein und konfigurier ihn mit deiner Discord-Server-ID und den Rollen-IDs
2. Importiere das Datenbankschema in die MySQL-Datenbank deines Servers mit der bereitgestellten SQL-Datei
3. Konfiguriere den Haupt config.lua Datei mit deinen Discord-Einstellungen, Datenbankanmeldedaten und Berechtigungsebenen
4. Richte das Web-Panel (optional) auf deinem Webserver mit den enthaltenen PHP/Node.js-Dateien ein.
5. Füge die Ressource zu deinem server.cfg und starte deinen Server neu
6. Teste das System, indem du dich mit einem Discord-Konto anmeldest und überprüfe, ob die Authentifizierung korrekt funktioniert
7. Konfiguriere deine ersten Berechtigungsstufen und Job-Whitelists im Admin-Panel

Konfigurationsoptionen

• Discord-Einstellungen – Bot-Token, Server-ID, Rollenzuordnungen, Benachrichtigungskanäle und Webhook-Konfigurationen
• Berechtigungsstufen – Definiere Stufennamen, erforderliche Discord-Rollen, Spielfunktionen und Prioritätsstufen
• Regeln für die Job-Whitelist – Konfiguriere, welche Jobs Whitelist-Genehmigung vs. offenen Zugriff, Genehmigungsworkflows und Einschränkungen erfordern
• Antragsformulare – Fragen, Pflichtfelder, Zeichenbegrenzungen und Anhangsoptionen für verschiedene Antragstypen anpassen
• Authentifizierungsmethoden – Primäre Discord-Authentifizierung plus Backup-Methoden wie Lizenzkennungen oder IP-basierte Erkennung
• Vorübergehender Zugang – Standardmäßige Ablaufzeiten, Verlängerungsprozesse und automatisierte Löschverfahren festlegen
• Warteschlangenintegration – Verbindung mit beliebten Warteschlangenressourcen herstellen, um Spielern auf der Whitelist Verbindungspriorität zu gewähren.
• Benachrichtigungseinstellungen – Steuerung der Ereignisse, die Discord-Nachrichten auslösen, der Empfänger dieser Nachrichten und der Nachrichtenformatierung

Framework-Kompatibilität

• ESX Vermächtnis – Vollständige Integration mit dem ESX-Auftragssystem, der Datenbankstruktur und den Berechtigungsframeworks
• ESX 1.9.x – Kompatibel mit älteren ESX-Versionen durch automatische Anpassung des Datenbankschemas
• QBCore – Native Unterstützung für QBCore-Auftragsverwaltung, Berechtigungsprüfung und Befehlsstrukturen
• QBOX – Funktioniert mit der QBOX-Framework-Architektur und den Berechtigungssystemen
• Standalone – Kann für benutzerdefinierte Frameworks mit Exporten und ereignisbasierter Integration angepasst werden.

Was es auszeichnet

Die meisten Whitelist-Skripte sind einfache “prüfen, ob Discord-Rolle existiert”-Systeme ohne Nuancen. Das Whitelist-System von ADN bietet Zugriffskontrolle auf Unternehmensebene, die mit kommerziellen Servermanagement-Plattformen mithalten kann. Allein die Automatisierung des Antrags-Workflows spart Hunderte von Admin-Stunden auf großen Servern – kein manuelles Nachverfolgen von Bewerber-Tabellen oder Kopieren und Einfügen von Discord-IDs in Datenbanktabellen mehr. Das mehrstufige Berechtigungssystem ermöglicht einen abgestuften Community-Zugriff anstelle eines binären Ja/Nein, wodurch Fortschrittspfade geschaffen werden, die die Spielerbindung verbessern.

Die Live-Berechtigungsaktualisierungen sind ein Game-Changer für die Administration. Einen Polizisten wegen Korruption feuern? Entferne sofort seine Whitelist und er verliert sofort den Zugang zum Abzeichen. Einen Spieler zum Gang-Anführer befördern? Gewähre ihm in Echtzeit erweiterte Berechtigungen. Keine "Relog zum Aktualisieren"-Meldungen mehr, keine Server-Neustarts, um Änderungen anzuwenden. Und die umfassende Protokollierung bedeutet, dass du immer weißt, wer was wann autorisiert hat und jedes Zugriffsproblem auf seine Quelle zurückführen kannst.

Sicherheitsfunktionen

• Anti-Spoofing – Mehrere Verifizierungsebenen verhindern, dass Spieler Discord-Identitäten fälschen oder die Authentifizierung umgehen.
• Verschlüsselte Kommunikation – Sensible Daten, die zwischen dem Spielserver und Discord übertragen werden, nutzen verschlüsselte Kanäle.
• Ratenbegrenzung – Schutz vor Spam-Anwendungen oder Brute-Force-Authentifizierungsversuchen
• Ausfallsichere Logik – Kann die Authentifizierung nicht überprüft werden (Discord nicht erreichbar, Datenbank nicht verfügbar), wird Spielern der Zutritt verweigert.
• Sitzungsvalidierung – Die kontinuierliche Überprüfung während des Spielablaufs verhindert Session-Hijacking oder Berechtigungsausnutzungen während des Spiels.
• IP-Tracking – Optionale IP-Protokollierung zur Sicherheitsanalyse und Erkennung von Sperrumgehungen

Gängige Einsatzszenarien

Neue Server beginnen mit einer grundlegenden zivilen Whitelist, die nur die Discord-Mitgliedschaft und eine einfache Bewerbung erfordert. Wenn die Community wächst, fügen sie Job-Whitelists für Polizei, EMS und Unternehmen hinzu. Etablierte Server verwenden mehrstufige Systeme mit dem Status “vertrauenswürdig”, der den Besitz von Eigentum freischaltet, dem Status “VIP”, der Warteschlangenpriorität bietet, und “Mitarbeiter”-Stufen, die Admin-Funktionen bereitstellen. Große Communities delegieren die Whitelist-Genehmigung – Gang-Anführer genehmigen ihre Rekruten, die PD-Führungsebene bearbeitet Offiziersbewerbungen, Geschäftsinhaber überprüfen Mitarbeiter.

Spielerlebnis

Aus Spielersicht ist der Bewerbungsprozess unkompliziert: Formular einreichen, auf die Prüfung warten und eine Bestätigung erhalten. Dank der Discord-Integration können Spieler ihren bestehenden Community-Account nutzen, anstatt separate Spielaccounts zu erstellen. Genehmigte Spieler schätzen die Priorität in der Warteschlange und wissen, dass die Whitelist-Pflicht problematische Spieler aussortiert. Die Transparenz des Systems (Überprüfung des eigenen Whitelist-Status per Befehl) beseitigt Unklarheiten darüber, warum man auf bestimmte Jobs keinen Zugriff hat.

Administrative Vorteile

Serverbetreiber erhalten die zentrale Kontrolle über den Community-Zugriff, ohne Datenbanktabellen manuell bearbeiten oder Server für Berechtigungsänderungen neu starten zu müssen. Das Antragssystem erstellt einen detaillierten Nachweis aller Zugriffsrechte – unerlässlich, um Streitigkeiten darüber beizulegen, wer problematische Spieler freigegeben hat. Die gestaffelte Struktur ermöglicht abgestufte Vertrauensstufen anstelle eines Alles-oder-Nichts-Prinzips. Die Automatisierung reduziert den Verwaltungsaufwand im Vergleich zur manuellen Whitelist-Verwaltung erheblich.

Anpassungsmöglichkeiten

Das modulare Design des Systems unterstützt umfangreiche Anpassungen. Füge benutzerdefinierte Antragsfragen hinzu, die spezifisch für die Lore deines Servers sind, integriere sie mit Charaktererstellungssystemen für automatische Hintergrundgenehmigungen, verbinde sie mit Spendensystemen für automatische VIP-Whitelist-Gewährungen oder baue benutzerdefinierte Berechtigungsebenen für server-spezifische Funktionen. Das API-ähnliche Exportsystem macht es einfach, den Whitelist-Status von anderen Ressourcen aus zu überprüfen.

Support und Dokumentation

ADNS Tech bietet eine umfassende Dokumentation zu Installation, Konfiguration, gängigen Anwendungsfällen und Fehlerbehebung. Support steht für Einrichtungshilfe, Fragen zur Integration und zur Lösung technischer Probleme zur Verfügung. Das System erhält regelmäßige Updates für FiveM-Kompatibilität, Discord-API-Änderungen und Sicherheitsverbesserungen. Die aktive Discord-Community bietet Unterstützung durch andere Nutzer und ermöglicht den Austausch von Konfigurationseinstellungen.