FiveM-Whitelist über Discord mit txAdmin: komplette Anleitung
Mit txAdmin kann die Whitelist deines FiveM-Servers an einer einzigen Discord-Rolle hängen: Wer die Rolle @Whitelisted hat, kommt rein, alle anderen werden an der Tür abgewiesen. Dazu ein Bewerbungsbot, der diese Rolle vergibt, sobald dein Team annimmt, und schon reicht das Annehmen einer Bewerbung, um einen Spieler freizuschalten. Keine Lizenz zum Kopieren, kein Konsolenbefehl.
Diese Anleitung dauert etwa 15 Minuten, von null bis zur ersten angenommenen Bewerbung.
So funktioniert es
Drei Bausteine, jeder mit einer Aufgabe:
| Baustein | Was er macht |
|---|---|
| Die Rolle @Whitelisted | Der Schlüssel zu deinem FiveM-Server |
| Toscio | Nimmt Bewerbungen in Discord an und vergibt die Rolle, wenn das Team annimmt |
| txAdmin | Prüft die Rolle bei jeder Verbindung und weist Spieler ohne sie ab |
Für den Spieler: Er kommt auf deinen Discord, klickt auf Bewerben, füllt das Whitelist-Formular aus, bekommt eine DM „Bewerbung angenommen“, startet FiveM und verbindet sich. Niemand aus deinem Team musste txAdmin öffnen.
Diese Anleitung folgt den Menüs von txAdmin 8, das mit aktuellen FXServer-Versionen ausgeliefert wird. Optionsnamen können sich zwischen Versionen leicht ändern. txAdmin ist auf Englisch: Die Optionsnamen stehen hier so, wie sie dort angezeigt werden.
Bevor du loslegst
Du brauchst:
- einen FiveM-Server mit txAdmin und ein txAdmin-Konto, das Einstellungen ändern darf;
- die Berechtigung Server verwalten auf deinem Discord;
- den Entwicklermodus von Discord, um IDs zu kopieren: Benutzereinstellungen → Erweitert → Entwicklermodus.
1. Die Rolle @Whitelisted anlegen
- Öffne auf deinem Discord Servereinstellungen → Rollen → Rolle erstellen.
- Nenn sie Whitelisted (oder WL, Bürger… der Name ist egal).
- Rechtsklick auf die Rolle, dann Rollen-ID kopieren. Heb die Nummer auf.
Gibt es bei dir eine Einreise oder eine Besucherphase? Leg auch eine Rolle @Besucher an: Toscio kann sie bei Annahme der Bewerbung entfernen.
2. Den Discord-Bot für txAdmin anlegen
txAdmin braucht einen eigenen Bot, um die Rollen deiner Spieler zu lesen. Das ist nicht Toscio, sondern dein eigener Bot, den nur txAdmin nutzt.
- Geh ins Discord Developer Portal und klick auf New Application. Gib ihm den Namen deines Servers.
- Klick im Tab Bot auf Reset Token und kopier den Token. Teil ihn nie: Er gibt volle Kontrolle über den Bot.
- Aktivier ebenfalls unter Bot den Server Members Intent und speicher. Ohne ihn sieht txAdmin keine Rollen.
- Hak unter OAuth2 → URL Generator den Scope bot an, öffne den erzeugten Link und füg den Bot deinem Discord-Server hinzu.
Wenn txAdmin die Discord-Einstellungen nicht speichert oder hängen bleibt, ist fast immer der fehlende Server Members Intent schuld.
3. Den Bot in txAdmin verbinden
- Öffne in txAdmin Settings und dann den Tab Discord.
- Aktivier Discord Bot.
- Füg den Token unter Token ein.
- Füg unter Guild/Server ID die ID deines Discord-Servers ein (Rechtsklick auf den Servernamen, Server-ID kopieren).
- Speichern.
4. txAdmin auf Whitelist per Discord-Rolle umstellen
- Öffne in Settings den Tab Whitelist.
- Wähl unter Allowlist Mode den Modus Discord Server Roles.
- Füg unter Allowlisted Discord Roles die ID der Rolle @Whitelisted ein. Mehrere gehen auch, durch Kommas getrennt (zum Beispiel @Whitelisted und @Team).
- Erklär unter Allowlist Instructions abgewiesenen Spielern, wie sie sich bewerben, zum Beispiel: „Komm auf discord.gg/deinserver und bewirb dich in #bewerbung.“
- Speichern.
Ab jetzt weist txAdmin jeden Spieler ohne die Rolle ab. Gib sie dir und deinem Team, bevor du testest.
5. Bewerbungen mit Toscio annehmen
Jetzt fehlt nur noch, die Rolle automatisch zu vergeben.
- Füg Toscio deinem Discord hinzu.
- Zieh unter Servereinstellungen → Rollen die Rolle Toscio über @Whitelisted. Discord lässt einen Bot nur Rollen unterhalb seiner eigenen vergeben.
- Nutze
/toscio setupmit:template: RP-Whitelist;channel: wo sich Spieler bewerben, zum Beispiel#bewerbung;staff-channel: ein privater Kanal für dein Whitelist-Team, zum Beispiel#wl-team;role: @Whitelisted;staff-role: die Rolle deines Whitelist-Teams, falls vorhanden.
Toscio postet das Panel mit dem Button Bewerben und bestätigt, wo die Bewerbungen ankommen. Dein erstes Formular kommt mit 14 Tagen Premium gratis, ohne Kreditkarte: die komplette Whitelist mit allen Fragen.
Für die Fragen schau dir die FiveM-Whitelist-Fragen an und bearbeite das Formular dann im Formular-Editor. In den Formulareinstellungen kannst du außerdem @Besucher bei Annahme entfernen lassen.
6. Den ganzen Ablauf testen
Mit einem zweiten Discord-Konto oder einem Freund:
- Klick auf Bewerben, füll die Whitelist aus und schick sie ab.
- Klick in
#wl-teamauf der Bewerbungskarte auf Annehmen. - Prüf, ob das Konto @Whitelisted und die Bestätigungs-DM bekommen hat.
- Öffne die Discord-Desktop-App, starte FiveM und verbinde dich: Du kommst rein.
- Nimm die Rolle weg und versuch es noch mal: txAdmin weist dich mit deinem Hinweistext ab.
Was dein Team sieht
Jede Bewerbung landet im Teamkanal, mit den Antworten, dem Alter des Discord-Kontos und dem Datum, an dem der Spieler deinem Server beigetreten ist, plus drei Buttons:
- Annehmen: Toscio vergibt @Whitelisted und schickt dem Spieler eine DM in seiner Sprache. Er kann sich sofort verbinden.
- Ablehnen: mit einem Grund, damit der Spieler weiß, was er verbessern kann. Eine Wartezeit von 24 Stunden (einstellbar) verhindert Spam-Bewerbungen.
- Gespräch: öffnet einen privaten Thread mit dem Spieler. Praktisch, um ein Sprachgespräch zu planen und danach anzunehmen.
Häufige Fehler
| Meldung oder Symptom | Ursache | Lösung |
|---|---|---|
| „You do not have the discord identifier“ | FiveM findet das Discord-Konto des Spielers nicht | Discord-Desktop-App (nicht den Browser) vor FiveM öffnen |
| „You are required to join our Discord server“ | Der Spieler ist nicht auf dem in txAdmin eingestellten Discord | Guild/Server ID prüfen und ob der Spieler dem richtigen Server beigetreten ist |
| „You do not have a allowlisted role“ | Dem Spieler fehlt die Rolle, oder die eingefügte ID ist falsch | Rollen-ID im Tab Whitelist prüfen |
| Annehmen schlägt in Toscio fehl | Die Toscio-Rolle steht unter @Whitelisted | Toscio-Rolle unter Servereinstellungen → Rollen nach oben ziehen |
| txAdmin speichert die Discord-Einstellungen nicht | Intent fehlt | Server Members Intent im Developer Portal aktivieren |
Der Spieler muss dasselbe Discord-Konto nutzen, mit dem er sich beworben hat: txAdmin prüft die Rolle des Discord-Kontos, das auf seinem PC offen ist.
Und die Whitelist per Lizenz?
txAdmin bietet auch den Modus Approved License: Jeder Spieler muss von Hand auf der Allowlist-Seite von txAdmin freigegeben werden, mit einer Anfrage-ID. Das funktioniert, aber jemand aus deinem Team muss es für jeden Spieler machen, zusätzlich zum Lesen der Bewerbung.
Mit einer Discord-Rolle sind Entscheidung und Zugang dasselbe. Rolle weg heißt Zugang weg, dein Team schaltest du mit einer zweiten Rolle frei, und die ganze Whitelist-Historie bleibt in Discord.
Weiter gehen
- Entbannungsanträge: Wer von deinem Discord gebannt ist, kann sich nicht mehr bewerben. Mit dem Webformular und Entbannungsanträgen stellt er einen Antrag auf einer Webseite, und Toscio hebt den Bann auf, wenn dein Team annimmt.
- Team-Abstimmungen: Mehrere Mitglieder deines Whitelist-Teams stimmen über jede Bewerbung ab, und Toscio entscheidet, sobald genug Stimmen da sind.
- Mehrere Formulare: Zivil-Whitelist, Polizei, Rettungsdienst, Team… jedes mit eigener Rolle und eigenem Kanal. Siehe die Seite zur FiveM-Whitelist.
Fragen
Wie richte ich eine FiveM-Whitelist mit Discord ein?
Aktiviere in txAdmin den Discord-Bot (Tab Discord), wähl dann im Tab Whitelist den Modus „Discord Server Roles“ und füg die ID deiner Rolle @Whitelisted ein. Nur Spieler mit dieser Rolle auf deinem Discord können sich verbinden. Ein Bewerbungsbot wie Toscio vergibt die Rolle, wenn dein Team die Bewerbung annimmt.
Warum bekommt ein Spieler „You do not have the discord identifier“?
FiveM findet sein Discord-Konto nicht. Der Spieler muss die Discord-Desktop-App öffnen (nicht die Browserversion), bevor er FiveM startet, und sich dann neu verbinden.
Braucht txAdmin neben Toscio einen eigenen Discord-Bot?
Ja. txAdmin nutzt einen eigenen Bot, den du im Discord Developer Portal anlegst, um die Rollen der Spieler zu lesen. Toscio kümmert sich um die Bewerbungen und vergibt die Rolle. Beide laufen nebeneinander, ohne sich zu stören.
Wie entferne ich jemanden von der Whitelist?
Nimm ihm auf Discord die Rolle @Whitelisted weg. txAdmin prüft die Rolle bei jeder Verbindung, also wird er beim nächsten Versuch abgewiesen.
Funktioniert die Whitelist per Discord-Rolle mit ESX und QBCore?
Ja. txAdmin prüft beim Verbinden, bevor das Framework ins Spiel kommt. Es funktioniert gleich mit ESX, QBCore, Qbox oder einem eigenen Framework.
