FiveM Whitelist einrichten: txAdmin & Discord-Rollen

Eine Whitelist entscheidet, wer auf deinen FiveM-Server darf. In txAdmin heißt die Funktion inzwischen Allowlist, im Code und in den Discord-Befehlen tauchen beide Begriffe auf. Diese Anleitung zeigt dir, welcher Modus zu deinem Projekt passt, wie du ihn einrichtest und wie du einen Bewerbungsprozess baust, der fair ist und nur die nötigen Daten sammelt. Stand: Oktober 2026, txAdmin 8.1.x.

Kurze Antwort: Welcher Modus passt zu deinem Server?

txAdmin bringt sechs Modi mit. Du findest sie unter Settings → Allowlist im Feld „Allowlist Mode“.

Modus in txAdmin	Was geprüft wird	Passt für
Disabled	Nur Bans (falls aktiv)	Öffentliche Server ohne Bewerbung
Admin-only (maintenance mode)	`fivem:`– oder `discord:`-Identifier gehört zu einem txAdmin-Admin	Wartung, Aufbauphase, interne Tests
Discord Server Member	Spieler ist Mitglied deines Discord-Servers	Semi-offene Server, die nur einen Discord-Beitritt verlangen
Discord Server Roles	Spieler ist Mitglied und hat mindestens eine der eingetragenen Rollen	Klassische RP-Whitelist mit Bewerbung
Approved License	`license:`-Identifier wurde von einem Admin freigegeben	Projekte ohne Discord-Bindung oder mit manueller Freigabe pro Spieler
External Allowlist Resource	txAdmin prüft nichts, deine eigene Resource entscheidet	Eigene Systeme, z. B. Bewerbungsportal mit Datenbank

Für die meisten deutschen RP-Server ist Discord Server Roles die pragmatische Wahl: Die Bewerbung läuft ohnehin über Discord, und die Freigabe ist ein Klick auf eine Rolle. Wer gar keine Hürde will, schaut sich an, wie Server ohne Whitelist funktionieren.

Grundlage: Server und txAdmin laufen

Bevor du die Allowlist anfasst, sollte dein Server sauber über txAdmin starten. Falls du noch am Anfang stehst, hilft dir die Anleitung FiveM-Server erstellen. Wichtig: Die Convars sv_appearAllowlisted und sv_allowlistInstructions setzt txAdmin selbst. Stehen sie in deiner server.cfg, kommentiert txAdmin sie aus, weil die Einstellungsseite sie überschreibt. Trag sie also nicht manuell ein.

Ist ein Modus außer „Disabled“ aktiv, zeigt die Serverliste ein Schloss-Symbol neben deinem Servernamen.

Schritt für Schritt: die Modi in txAdmin einrichten

Admin-only (Wartungsmodus)

Öffne Settings → Allowlist und wähle „Admin-only (maintenance mode)“.
Prüfe im Admin-Manager, dass bei jedem Teammitglied die FiveM- oder Discord-ID hinterlegt ist. Ohne eine dieser IDs kommt auch ein Admin nicht rein.
Speichern. txAdmin prüft die Allowlist bei jedem Verbindungsversuch.

Approved License

Modus „Approved License“ wählen.
Das Feld „Allowlist Instructions“ ausfüllen (Pflicht, maximal 512 Zeichen). Der Text erscheint auf der Serverseite im Client und in der Ablehnungsmeldung, z. B. „Bewirb dich in unserem Discord im Kanal #bewerbung und nenne deine Whitelist-ID.“
Versucht ein Spieler zu joinen, legt txAdmin automatisch eine Anfrage mit einer ID im Format R1234 an und zeigt sie dem Spieler als „Whitelist-ID“.
Unter Allowlist in der Navigation siehst du links die offenen Anfragen (annehmen, ablehnen oder alle ablehnen) und rechts bereits freigegebene Spieler, die noch nicht gejoint sind. Über „Add Approval“ kannst du Spieler auch vorab freigeben.

Alternativ geht die Freigabe per Discord-Bot: /allowlist request mit der Anfrage-ID oder /allowlist member mit einem Discord-Mitglied (die ältere Variante /whitelist existiert parallel). Der Befehl funktioniert nur, wenn dein Discord-Account in txAdmin einem Admin mit der Berechtigung players.whitelist zugeordnet ist.

Discord Server Member und Discord Server Roles

Beide Modi lassen sich erst auswählen, wenn der Discord-Bot im Discord-Tab aktiv ist. Die Einrichtung des Bots folgt im nächsten Abschnitt. Danach:

„Discord Server Member“ oder „Discord Server Roles“ wählen.
„Allowlist Instructions“ ausfüllen, etwa mit Link zum Discord und Hinweis auf die Bewerbung.
Nur bei Rollen: Unter „Allowlisted Discord Roles“ die Rollen-IDs eintragen, mehrere durch Komma getrennt. Es reicht, wenn der Spieler eine davon hat.

External Allowlist Resource

Hier überspringt txAdmin die Allowlist-Prüfung komplett (Bans prüft es weiterhin, wenn aktiviert). Deine eigene Resource muss Verbindungen dann selbst ablehnen. Das lohnt sich nur, wenn du bereits ein eigenes Bewerbungs- oder Accountsystem betreibst.

Discord-Bot einrichten: Bot, Server-ID, Rollen-IDs

Diese Anleitung nutzt den Bot, der in txAdmin eingebaut ist. Eine Variante mit separatem Whitelist-Bot beschreibt unsere Anleitung: Discord Whitelist erstellen.

Im Discord Developer Portal eine Anwendung anlegen und einen Bot erstellen. Das Token kopieren und sicher aufbewahren, es gehört nirgendwo öffentlich hin.
Beim Bot den privilegierten Intent Server Members aktivieren. txAdmin verlangt ihn ausdrücklich. Fehlt er, scheitert der Bot-Start mit dem Hinweis, dass ein erforderlicher privilegierter Intent fehlt.
Den Bot auf deinen Discord-Server einladen.
In Discord unter Einstellungen → Erweitert den Entwicklermodus einschalten. Danach kannst du per Rechtsklick die Server-ID und unter Servereinstellungen → Rollen die ID jeder Rolle kopieren.
In txAdmin unter Settings → Discord den Bot aktivieren, „Token“ und „Guild/Server ID“ eintragen, speichern.
Zurück zur Allowlist und den Rollenmodus mit den kopierten Rollen-IDs aktivieren.

Lege am besten eine eigene Rolle wie „Whitelisted“ an, statt bestehende Rollen wie „Mitglied“ wiederzuverwenden. So nimmst du bei Regelverstößen genau diese eine Rolle weg, ohne den Rest der Discord-Rechte anzufassen.

Bewerbungsprozess gestalten

Die Technik ist in einer halben Stunde erledigt. Was deinen Server prägt, ist der Prozess dahinter. Wie das aus Spielersicht aussieht, beschreibt der Artikel zur Whitelist-Bewerbung. Aus Betreibersicht haben sich diese Punkte bewährt:

Fragen

Wenige, gezielte Fragen statt langer Formulare: RP-Erfahrung, eine kurze Charakteridee, zwei bis drei Szenariofragen zu deinen Regeln.
Frag Regelwissen ab, das wirklich zählt, etwa zu Fear-RP oder Metagaming. Dafür brauchst du ein klares Regelwerk.
Kein Mindestumfang in Wörtern. Lange Texte sagen wenig über gutes Rollenspiel.

Prüfung

Mindestens zwei Teammitglieder schauen sich jede Bewerbung an, mit einer kurzen Checkliste, damit Entscheidungen vergleichbar bleiben.
Lege eine Bearbeitungszeit fest und kommuniziere sie, z. B. „innerhalb von 72 Stunden“.
Optional: kurzes Sprachgespräch im Discord für Grenzfälle.

Ablehnung

Kurze Begründung, ein konkreter Verbesserungshinweis, eine feste Wartezeit bis zur nächsten Bewerbung.
Keine öffentlichen Ablehnungen im Kanal, sondern per Direktnachricht oder Ticket.

Datensparsamkeit (DSGVO)

Frag nur ab, was du für die Entscheidung brauchst. Für eine RP-Whitelist sind das in der Regel Discord-Name, Alter nur als „ab X Jahren: ja/nein“ und die inhaltlichen Antworten. Klarnamen, Wohnort, Fotos oder Ausweisdaten brauchst du nicht. Leg fest, wer die Bewerbungen sehen darf und wann sie gelöscht werden, etwa 30 Tage nach der Entscheidung. Das entspricht dem Grundsatz der Datenminimierung aus Art. 5 DSGVO. Bei rechtlichen Detailfragen hilft eine Fachperson weiter, nicht diese Anleitung.

Häufige Probleme und Lösungen

Spieler wird nicht erkannt, obwohl er die Rolle hat

Die Discord-Modi brauchen den discord:-Identifier. Laut txAdmin-Meldung braucht der Spieler dafür die geöffnete Discord-App, die Web-Version wird nicht unterstützt. Lösung: Discord-App öffnen, FiveM neu starten, erneut verbinden. Kommt der Spieler direkt nach dem Discord-Beitritt nicht rein, kurz warten und noch einmal versuchen, weil txAdmin seine Mitgliederliste zwischenspeichert.

Identifier passt nicht

Im Modus „Approved License“ zählt der license:-Identifier, also die an den Rockstar-Account gebundene Lizenz. Wer mit einem anderen Rockstar-Account startet, bekommt eine neue Anfrage-ID. Gib lieber die neue Anfrage frei, statt alte Einträge zu suchen. Fehlt die Lizenz komplett, läuft der Server vermutlich mit sv_lan true. Das schaltet die Lizenzprüfung ab und nimmt den Server aus der öffentlichen Liste. Für einen Live-Server gehört das auf false.

Bot läuft nicht oder Discord-Modi sind ausgegraut

Ausgegraute Optionen bedeuten: Der Bot ist im Discord-Tab nicht aktiviert. Startet er nicht, prüfe Token, Server-ID und den Server-Members-Intent. Rollen-IDs im falschen Format lehnt txAdmin schon beim Speichern ab. Eine formal gültige, aber falsche ID (z. B. aus einem anderen Discord) fällt erst beim Join auf.

Admin kommt im Wartungsmodus nicht rein

Im Admin-Manager fehlt die FiveM- oder Discord-ID des Accounts. Nachtragen, speichern, neu verbinden.

FAQ

Kann ich Discord-Rollen und Approved License kombinieren?

Nein, txAdmin prüft immer genau einen Modus. Wer beides will, nutzt „External Allowlist Resource“ mit eigener Logik.

Wo stelle ich die Nachricht für abgelehnte Spieler ein?

Im Feld „Allowlist Instructions“ unter Settings → Allowlist. Der Text erscheint in der Ablehnungsmeldung und auf der Serverseite in der FiveM-Serverliste.

Muss der Server nach einer Rollenvergabe neu starten?

Nein. Die Prüfung läuft bei jedem Verbindungsversuch. Hat der Spieler die Rolle, kommt er beim nächsten Connect rein.

Kann ich die Whitelist mit eigenen Scripts verbinden?

Ja. txAdmin sendet Server-Events wie txAdmin:events:whitelistRequest, txAdmin:events:whitelistPlayer und txAdmin:events:whitelistPreApproval. Damit kannst du z. B. neue Anfragen in einen Team-Kanal melden. Die Felder stehen in der txAdmin-Event-Dokumentation.