FiveM Whitelist über Discord: Bewerbung, Prüfung, Rollen und Einreise sauber verbinden

Whitelist•Von Web-Services Team••9 Min. Lesezeit

Eine FiveM Whitelist über Discord funktioniert so: Bewerber reichen im Discord eine Bewerbung ein, das Team prüft sie, und bei Zusage wird die Discord-ID freigeschaltet, meist über eine Rolle oder einen Datenbankeintrag. Beim Verbinden prüft der Server diese ID und lässt nur freigeschaltete Spieler herein, die dann im Spiel noch die Einreise durchlaufen. Ein Whitelist-Bot übernimmt dabei die wiederkehrenden Schritte wie Freischalten, Sperren und Protokollieren.

Dieser Beitrag zeigt den Ablauf von der Bewerbung bis zum ersten Schritt in die Stadt, mit einem Beispiel für die Prüfung beim Verbinden, einer Checkliste und den Fehlern, an denen gute Bewerber unterwegs abspringen.

Wie funktioniert eine FiveM Whitelist mit Discord?

Die Whitelist trennt zwei Fragen: Wer darf überhaupt auf den Server, und wer darf in die Stadt? Discord beantwortet die erste Frage, weil dort Bewerbung, Kommunikation und Teamentscheidung ohnehin stattfinden. Die zweite Frage klärt die Einreise im Spiel.

Technisch braucht es eine gemeinsame Kennung. Das ist die Discord-ID, die FiveM als Identifier im Format discord:123456789012345678 mitliefert, sofern der Spieler beim Start von FiveM die Discord-App geöffnet hat. Über diese ID verbindet der Server den Spieler mit seiner Freigabe.

Für die Freigabe gibt es zwei gängige Varianten:

  • Datenbank-Whitelist: Ein Bot oder Teammitglied trägt die Discord-ID in eine Tabelle ein. Der Server fragt beim Verbinden diese Tabelle ab. Das ist schnell und unabhängig von der Discord-API.
  • Rollen-Check: Der Server fragt beim Verbinden über einen Bot-Token bei Discord nach, ob das Mitglied eine bestimmte Rolle hat. Das spart die Tabelle, hängt aber an der Erreichbarkeit der Discord-API.

In der Praxis kombinieren viele Server beides: Die Rolle zeigt im Discord sichtbar den Status an, die Datenbank ist die verbindliche Quelle für den Serverzugang.

Schritt für Schritt: den Whitelist-Ablauf aufsetzen

  1. Kanäle anlegen: einen öffentlichen Kanal mit Regeln und Ablauf, einen Kanal oder ein Ticket-System für Bewerbungen, einen internen Kanal für das Team und einen Log-Kanal.
  2. Rollen festlegen: zum Beispiel Bewerber, Whitelisted, Gesperrt und eine Teamrolle für Prüfer. Nur Prüfer dürfen freischalten.
  3. Bewerbungsformat definieren: feste Fragen, damit jede Bewerbung gleich aufgebaut ist und das Team schnell vergleichen kann.
  4. Prüfkriterien schriftlich festhalten: Was führt zur Zusage, was zur Ablehnung, wann wird nachgefragt?
  5. Freigabe technisch umsetzen: Eintrag in die Whitelist-Tabelle und Rolle vergeben, idealerweise per Bot-Befehl in einem Schritt.
  6. Prüfung beim Verbinden einbauen: Der Server liest die Discord-ID aus und vergleicht sie mit der Whitelist.
  7. Einreise anbinden: Freigeschaltete Spieler landen nicht direkt in der Stadt, sondern im Einreisebereich.
  8. Logs und Rückmeldung testen: Mit einem Testaccount den kompletten Weg einmal durchspielen, inklusive Ablehnung und Sperre.

Die Bewerbung: welche Fragen wirklich etwas aussagen

Eine Bewerbung soll zeigen, ob jemand Roleplay versteht und die Regeln gelesen hat. Lange Romane über die Kindheit des Charakters sagen darüber wenig aus. Kurze, gezielte Fragen sind ergiebiger:

  • Discord-Name und Alter, falls ihr eine Altersgrenze habt
  • Bisherige RP-Erfahrung in zwei bis drei Sätzen
  • Kurzes Charakterkonzept: Name, Hintergrund, Ziel in der Stadt
  • Eine Regelfrage mit Szenario, etwa: "Du wirst ausgeraubt und kennst den Täter aus einem anderen Discord. Was machst du?"
  • Zustimmung zu den Serverregeln

Die Szenariofrage trennt am zuverlässigsten zwischen Bewerbern, die Begriffe wie Metagaming nur auswendig kennen, und solchen, die sie anwenden können. Eine oder zwei solcher Fragen reichen.

Prüfung durch das Team: Kriterien, Zuständigkeit und Fristen

Die häufigste Schwachstelle ist nicht die Technik, sondern die Prüfung. Wenn jeder Prüfer nach Gefühl entscheidet, fühlen sich Bewerber ungerecht behandelt und das Team diskutiert Einzelfälle endlos.

Bewährt hat sich ein kurzer interner Leitfaden mit drei Ausgängen: Zusage, Rückfrage, Ablehnung mit Grund. Lege außerdem fest, wer zuständig ist, etwa durch eine Reaktion oder einen Claim im Ticket, damit nicht zwei Leute dieselbe Bewerbung bearbeiten oder sie liegen bleibt.

Setz dir eine interne Frist für die erste Rückmeldung und kommuniziere sie öffentlich. Welche Frist realistisch ist, hängt von deiner Teamgröße ab. Wichtig ist, dass sie eingehalten wird. Bei hohem Andrang hilft ein optionales Gespräch im Voice-Wartebereich statt schriftlicher Rückfragen, weil sich viele Unklarheiten in fünf Minuten klären.

Jede Entscheidung gehört mit Grund ins Log. Das schützt das Team bei Beschwerden und macht spätere Sperren nachvollziehbar.

Rolle vergeben und Serverzugang beim Verbinden prüfen

Nach der Zusage muss die Freigabe dort ankommen, wo der Server nachschaut. Das folgende Beispiel zeigt eine Datenbank-Whitelist mit oxmysql. Es liest die Discord-ID aus, fragt die Tabelle ab und gibt verständliche Meldungen zurück:

AddEventHandler('playerConnecting', function(name, setKickReason, deferrals)
    local src = source
    deferrals.defer()
    Wait(0)
    deferrals.update('Whitelist wird geprüft ...')

    local discordId
    for _, id in ipairs(GetPlayerIdentifiers(src)) do
        if id:sub(1, 8) == 'discord:' then
            discordId = id:sub(9)
        end
    end

    if not discordId then
        deferrals.done('Kein Discord erkannt. Discord-App starten, dann FiveM neu öffnen.')
        return
    end

    local row = MySQL.single.await('SELECT status FROM whitelist WHERE discord_id = ?', { discordId })

    if row and row.status == 'aktiv' then
        deferrals.done()
    elseif row and row.status == 'gesperrt' then
        deferrals.done('Dein Zugang ist gesperrt. Wende dich an den Support im Discord.')
    else
        deferrals.done('Noch nicht freigeschaltet. Bewerbung im Discord unter #whitelist.')
    end
end)

Drei Punkte machen hier den Unterschied: Die Abfrage läuft serverseitig, der Status hat mehr als zwei Zustände, und jede Ablehnung sagt dem Spieler, was er als Nächstes tun soll. Eine nackte Meldung wie "Du bist nicht gewhitelistet" erzeugt Support-Tickets.

Wenn du stattdessen Rollen über die Discord-API prüfst, plane einen Fallback für den Fall, dass Discord nicht antwortet, und rufe die API nicht bei jedem Verbindungsversuch ungebremst auf. Logs zur Freigabe kannst du wie in der Anleitung zum Discord Webhook für sichere Server-Logs aufbauen.

Whitelist und Einreise im Spiel zusammenspielen lassen

Die Discord-Whitelist prüft eine schriftliche Bewerbung. Ob jemand im Spiel tatsächlich Roleplay spielen kann, zeigt sie nicht. Deshalb ist die Einreise die zweite Stufe: Der freigeschaltete Spieler landet in einem abgetrennten Bereich, ein Teammitglied spricht mit ihm, prüft Charakter und Aussehen und lässt ihn dann in die Stadt.

Die Discord-Whitelist entscheidet, wer auf den Server darf, die Einreise im Spiel entscheidet, wer in die Stadt darf. Wer beides trennt, kann die schriftliche Hürde niedrig halten, ohne an Qualität zu verlieren.

Daraus folgt eine praktische Abwägung: Je gründlicher die Einreise, desto kürzer darf die Bewerbung sein. Viele Server verlieren Bewerber, weil sie beide Stufen gleich streng gestalten und dieselben Fragen zweimal stellen. Wie die Einreise selbst organisiert wird, mit Dienstplan und Schutz vor Moddern, steht im Beitrag zum FiveM Einreise-System mit Ablauf und Teamorganisation.

Wichtig für das Zusammenspiel: Eine Sperre muss beide Stufen treffen. Wird jemand bei der Einreise abgelehnt oder später gebannt, sollte auch sein Whitelist-Status auf gesperrt gehen, sonst bewirbt er sich einfach neu.

Was ein Whitelist-Bot im Ablauf automatisiert

Ohne Bot sieht die Freigabe oft so aus: Ein Teammitglied vergibt die Rolle, ein anderes trägt die ID in die Datenbank ein, und das Log schreibt niemand. Ein Bot fasst das in Slash-Commands zusammen. Typische Aufgaben:

  • Freischalten eines Users per Befehl, mit Rolle und Eintrag in einem Schritt
  • Sperren, auch zeitlich begrenzt, mit Grund
  • Zurücksetzen eines Users, etwa nach einem Charakterwechsel
  • Erzwungene Aktionen für Sonderfälle, die im Log als solche erkennbar sind
  • Protokoll jeder Aktion mit ausführendem Teammitglied

Der eigentliche Gewinn ist nicht Zeitersparnis, sondern Konsistenz: Jede Freigabe läuft gleich ab und ist nachvollziehbar. Achte darauf, dass nur die Prüferrolle die Befehle nutzen darf und dass der Bot-Token nirgends im Klartext in geteilten Dateien liegt.

Fehler, die Bewerber vergraulen

  • Keine Rückmeldung: Bewerbungen, die tagelang unbeantwortet bleiben, sind der häufigste Grund für Abwanderung. Eine automatische Eingangsbestätigung mit realistischer Frist hilft.
  • Ablehnung ohne Grund: Wer nicht weiß, was falsch war, bewirbt sich nicht erneut, sondern geht.
  • Zu lange Formulare: Zwanzig Pflichtfragen schrecken genau die erfahrenen Spieler ab, die du haben willst.
  • Unklare Technikhürden: Wer nicht weiß, dass Discord beim Start von FiveM laufen muss, scheitert an der Verbindung und hält den Server für kaputt.
  • Doppelte Prüfung: Dieselben Regelfragen in Bewerbung und Einreise wirken wie Misstrauen.
  • Willkürliche Wartesperren: Sperrfristen nach Ablehnung sind sinnvoll, sollten aber in den Regeln stehen und nicht im Einzelfall erfunden werden.

Checkliste für die Discord-Whitelist

  • Regeln und Ablauf öffentlich und auffindbar
  • Feste Bewerbungsfragen mit mindestens einer Szenariofrage
  • Interner Prüfleitfaden mit Zusage, Rückfrage, Ablehnung
  • Zuständigkeit pro Bewerbung klar geregelt
  • Freigabe setzt Rolle und Whitelist-Eintrag gleichzeitig
  • Serverprüfung beim Verbinden mit verständlichen Meldungen
  • Status "gesperrt" wirkt auf Discord und Server
  • Log-Kanal für alle Entscheidungen
  • Kompletter Ablauf einmal mit Testaccount durchgespielt

Umsetzung mit Scripts und Bots von Web-Services

Für den Discord-Teil gibt es von Web-Services einen Whitelist-Bot mit Slash-Commands und Logs. Die Befehle decken Freischalten (/wladd), Sperren (/wlsperre), Zurücksetzen mit Grund (/wlreset) sowie erzwungene Varianten ab, darunter eine zeitlich begrenzte Sperre (/wlforcesperre mit Zeit und Grund). Nachrichten und Funktionen sind per Config anpassbar, der Bot läuft mit eigenem Namen und Logo und benötigt eine MySQL-Datenbank. Wer diesen Weg gehen will, kann den Whitelist Bot für Discord kaufen und ihn nach dem Kauf mit der Tebex-ID im Control Panel einlösen. Wie die Freigabe in deinem Setup beim Server ankommt, klärst du vor der Einrichtung am besten im Support-Discord.

Für die zweite Stufe im Spiel ist ws_einreise eine Möglichkeit auf ESX-Servern: Neue Spieler landen in einer eigenen Einreise-Dimension, das Team hat ein Whitelist-Menü, Kick und Ban, Skin-Menü und ein Duty-System, und jede Aktion wird per Webhook protokolliert. Wer das System nicht selbst bauen möchte, kann das FiveM Einreise Script kaufen.

FAQ

Warum erkennt der Server die Discord-ID mancher Spieler nicht?

FiveM liefert den Discord-Identifier nur, wenn die Discord-Desktop-App beim Start von FiveM läuft. Wer Discord nur im Browser nutzt oder FiveM vorher öffnet, hat keinen discord:-Identifier. Weise in der Fehlermeldung beim Verbinden direkt darauf hin.

Reicht eine Discord-Rolle als Whitelist aus?

Sie reicht, wenn der Server die Rolle beim Verbinden zuverlässig über die Discord-API prüft. Robuster ist eine Datenbank-Whitelist als verbindliche Quelle, weil sie nicht von der Erreichbarkeit der API abhängt. Die Rolle dient dann der Sichtbarkeit im Discord.

Brauche ich zusätzlich eine Einreise im Spiel?

Nicht zwingend, aber sie prüft, was eine schriftliche Bewerbung nicht zeigen kann: wie jemand tatsächlich spielt. Mit Einreise kannst du die Bewerbung kürzer halten und senkst so die Hürde für neue Spieler.

Wie verhindere ich, dass gesperrte Spieler sich neu bewerben?

Führe einen eigenen Status "gesperrt" statt den Eintrag zu löschen. So erkennt das Team bei einer neuen Bewerbung mit derselben Discord-ID sofort die Vorgeschichte, und der Server lehnt die Verbindung mit passender Meldung ab.

Anmelden

FAQ

Du bekommst Hilfe bei Fragen oder der Einrichtung unserer Produkte auf unserem Discord (discord.gg/webservices).

Du kannst das gekaufte Skript direkt im CFX Portal (portal.cfx.re) herunterladen und dann auf deinem Server verwenden.

Leider ist eine Rückerstattung nicht möglich.

Du kannst unser Control Panel über den folgenden Link erreichen: control-panel.ws

Alle Rechte vorbehalten. 2021-2026 © WS Shop
Kostenlose ScriptsYouTube
Nutzungsbedingungen
Datenschutz
Impressum
Gestaltet von: Mattiwe Design