FiveM Discord Whitelist einrichten (Anleitung 2026)

Einen FiveM Server zu betreiben ist harte Arbeit. Du verbringst Stunden damit, Skripte und Autos zu konfigurieren, da ist das Letzte, was du willst, dass zufällige Trolle den Spaß verderben. Du musst kontrollieren, wer reinkommt.

Der beste Weg, dies zu tun, ist eine Discord Whitelist. Diese verknüpft deinen Spielserver mit deinem Discord-Server. Wenn ein Spieler nicht in deinem Discord ist oder nicht die richtige Rolle hat, kann er dem Spiel nicht beitreten. So einfach ist das.

In diesem Leitfaden zeige ich dir genau, wie du dies mit den zwei besten Methoden für 2026 einrichtest.

Das Discord Developer Portal

Bevor du Skripte herunterlädst, musst du deinen Discord Bot einrichten. Hier bleiben die meisten Leute stecken, also befolge diese Schritte sorgfältig.

1. Die App erstellen

   Gehe zum Discord Developer Portal. Klicke auf Neue Anwendung und nenne sie zum Beispiel „Server Gatekeeper“. Klicke dann auf den Reiter Bot auf der linken Seite und klicke auf „Bot hinzufügen“.

2. Die Intents einschalten

   Dies ist der wichtigste Teil. Scrolle nach unten zum Abschnitt „Privileged Gateway Intents“. Du musst den Server Members Intent einschalten. Wenn du dies nicht tust, kann der Bot nicht sehen, wer auf deinem Server ist, und die Whitelist wird fehlschlagen.

3. Deine Schlüssel erhalten

   Du brauchst drei Dinge. Kopiere dein Bot-Token (vom Bot-Tab), deine Client-ID (vom OAuth2-Tab) und deine Guild-ID (Rechtsklick auf dein Serversymbol in Discord und klicke auf „ID kopieren“). Speichere diese in einem Notizblock für später.

Empfohlen

Mache das Warten lohnenswert

Eine sichere Whitelist ist unerlässlich, stellt aber auch eine Eintrittsbarriere dar. Wenn Spieler einmal zugelassen sind, verliere sie nicht durch einen langweiligen Ladebildschirm. Unsere Night Raid Vorlage bietet eine professionelle, animierte Einführung in deine Welt.

Hole dir die Vorlage

Methode 1: Der „Badger“-Stack (Am besten für RP-Server)

Wenn du einen Rollenspielserver betreibst, benötigst du wahrscheinlich unterschiedliche Berechtigungen für verschiedene Personen. Zum Beispiel möchtest du vielleicht, dass die Polizei Zugang zu einem speziellen Menü hat oder Spender Zugang zu speziellen Autos. Der beste Weg, dies zu tun, ist die Kombination von zwei Skripten: Badger_Discord_API und DiscordAcePerms.

• Badger_Discord_API

  Dieses Skript erledigt die Hauptarbeit. Es kommuniziert mit Discord und speichert die Daten, damit dein Server nicht überlastet wird. Hier herunterladen.

• DiscordAcePerms

  Dieses Skript verknüpft deine Discord-Rollen mit FiveM-Berechtigungen. Hier herunterladen.

So installierst du es

Lade beide Ordner herunter und lege sie in deinen Ressourcenordner. Du musst die Ordner genau in Badger_Discord_API und DiscordAcePerms umbenennen. Entferne jeglichen zusätzlichen Text wie „-master“, sonst funktionieren die Skripte nicht.

Als Nächstes öffne deine server.cfg Datei und füge diese Zeilen hinzu. Die Reihenfolge ist wichtig:

# Start the API first
ensure Badger_Discord_API

# Give AcePerms permission to change server settings
add_ace resource.DiscordAcePerms command.add_principal allow
add_ace resource.DiscordAcePerms command.remove_principal allow

# Start the Permission script
ensure DiscordAcePerms

Gehe schließlich in den DiscordAcePerms Ordner und öffne config.lua. Du siehst eine Liste, in die du deine Rollen-IDs einfügen kannst.

roleList = {
    -- {DiscordRoleID, "AceGroup"}
    {123456789012345678, "group.admin"}, 
    {987654321098765432, "group.member"},
}

Methode 2: txAdmin (Einfachste Methode)

Wenn du dich nicht mit Code-Dateien herumschlagen möchtest, kannst du txAdmin verwenden. Dies ist das Webpanel, das mit FiveM geliefert wird. Es verfügt über eine integrierte Whitelist, die sehr einfach zu bedienen ist.

1. Einstellungen öffnen

   Gehe in deinem Browser zu deiner txAdmin-Seite (normalerweise localhost:40120). Klicke auf Einstellungen und dann auf Discord Bot.

2. Schlüssel eingeben

   Füge das Token, die Client-ID und die Guild-ID ein, die du zuvor gespeichert hast.

3. Whitelist einschalten

   Gehe zum Reiter Spielerverwaltung. Wechsle den Modus auf „Discord Server Roles“. Gib dann einfach die Rollen-IDs der Personen ein, die du zulassen möchtest.

Warum funktioniert es nicht?

Wenn du alles eingerichtet hast, aber Spieler immer noch gekickt werden, überprüfe diese drei häufigen Probleme.

„Identifier Not Found“

Dies geschieht, wenn FiveM nicht mit der Discord-App auf dem PC des Spielers kommunizieren kann. Um dies zu beheben, sage deinen Spielern, dass sie:

• FiveM vollständig schließen sollen.
• Discord öffnen und sicherstellen, dass es nicht minimiert ist.
• FiveM erneut öffnen sollen. Es könnte ein Popup in Discord erscheinen, das zur „Autorisierung“ auffordert. Sie müssen auf Ja klicken.

„Roles == False“

Wenn die Konsole anzeigt, dass Rollen falsch oder fehlen, hast du wahrscheinlich das Gateway Intents im Developer Portal. Gehe zurück zum ersten Schritt dieser Anleitung und stelle sicher, dass diese Schalter aktiviert sind.

Welche Methode solltest du verwenden?

Wenn du nur verhindern möchtest, dass zufällige Personen beitreten, verwende txAdmin. Es ist schneller und einfacher. Wenn du einen komplexen RP-Server möchtest, auf dem Polizei und Admins automatisch unterschiedliche Befugnisse haben, verwende den Badger Stack.

Für diejenigen, die einen Bot möchten, der auch Chat und Moderation übernimmt, kannst du dir auch zdiscord, ansehen, aber die Einrichtung erfordert etwas mehr Aufwand.