Spare 20 % mit WELCOMEAngebote ansehen
Wie man eine Discord-Whitelist für seinen FiveM-Server einrichtet (…

Wie man eine Discord-Whitelist für seinen FiveM-Server einrichtet (…

Publikum: FiveM-Serverbesitzer und -Entwickler
Schwierigkeit: Einfach → Mittel
Ergebnis: Rollenbasierte Whitelist mit Discord-Rollen (mit optionaler Blacklist), minimaler Wartungsaufwand, klares Spieler-Feedback.

Hinweis zu den Versionen: Das Open‑Source‑Repository FAXES/DiscordWhitelist ist community-pflegeleitet und wurde zuletzt 2022 aktualisiert. Es funktioniert immer noch für viele Server. Eine gepflegte kommerzielle Version existiert; wenn du Unterstützung/SLA benötigst, berücksichtige sie. Dieser Leitfaden behandelt die kostenlose GitHub-Version.

Kurz zusammengefasst

  1. Erstelle einen Discord Bot → aktivieren Absicht der Servermitglieder → lade es zu deinem Discord ein.
  2. Kopiere dein Gilden-(Server-)ID Und Rollen-ID(s).
  3. Herunterladen: FAXES/DiscordWhitelist auf GitHub → steck es rein Ressourcen/ → konfigurieren server.js.
  4. Hinzufügen stelle DiscordWhitelist sicher Zu server.cfg (oder in txAdmin starten).
  5. Test: Beitritt ohne Rolle (blockiert) → Rolle hinzufügen → erneut beitreten (erlaubt).

Verwandte Tutorials:
• FiveM-Whitelist – Vollständige Anleitung (txAdmin, Skripte, DB)
• So erstellst du Discord-Spendenstufen

Warum Discord-basierte Whitelists?

  • Dynamisch: Gewähre/verweigere Zugriff, indem du eine Discord-Rolle hinzufügst/entfernst – keine ACE- oder DB-Änderungen.
  • Skalierbar: Mods können den Zugriff von Discord auf Mobilgeräten verwalten.
  • Überprüfbar: Rollenverlauf + Moderationsprotokolle zeigen, wer wem erlaubt hat.

Voraussetzungen

  • Ein Discord-Server (du bist Admin/Besitzer).
  • FiveM-Server mit txAdmin oder manueller Steuerung.
  • Spieler müssen die Discord-Desktop-App läuft beim Verbinden (also FiveM stellt eine Zwietracht: Kennung).

Schritt 1 — Erstelle einen Discord-Bot & Aktiviere Intents

  1. Gehe zu dem Discord-Entwicklerportal → Neue Anwendung → benenne ihn (z. B., FiveMX Whitelist-Bot).
  2. Einen Bot hinzufügen (Bot-Registerkarte) → Token zurücksetzen → kopiere den Bot-Token (speichere ihn sicher).
  3. Unter Absichten für privilegierte Gateways, aktivieren Absicht der Servermitglieder. (Eine Anwesenheitsabsicht ist nicht erforderlich.)
  4. Lade den Bot zu deinem Discord ein: OAuth2 → URL-Generator → Scopes: Bot; Berechtigungen: minimal (kann keine über das Beitreten hinaus sein). Verwende die generierte URL und füge sie zu deinem Guild hinzu.

Sicherheit: Behandle den Bot-Token wie ein Passwort. Du nicht solltest ihn nicht in Git committen oder in Screenshots teilen. Drehe ihn um, wenn er geleakt wurde.

Schritt 2 — Hole deine IDs (Guild & Rollen)

  • In Discord → Benutzereinstellungen → Erweitert → Entwicklermodus: AN.
  • Klicke mit der rechten Maustaste auf dein Servername → Server-ID kopieren.
  • Servereinstellungen → Rollen → klicke mit der rechten Maustaste auf die Rolle, die du als Whitelist verwenden wirst (z. B., Auf der Whitelist) → Rollen-ID kopieren.
  • (Optional) Kopiere IDs für alle Rollen, die du schwarze Liste (z.B, Verboten).

Behalte diese griffbereit:

  • GUILD_ID = 123456789012345678
  • WHITELIST_ROLE_IDS = ["111111111111111111", "2222222222222222222"]
  • BLACKLIST_ROLE_IDS = ["3333333333333333333"]

Schritt 3 – Herunterladen und Installieren der Ressource

  1. Herunterladen die ZIP von FAXES/DiscordWhitelist (GitHub).
  2. Extrahiere sie auf deinen Server unter:
    Ressourcen/[Discord]/DiscordWhitelist
  3. Überprüfe, dass der Ordner mindestens enthält:
    • fxmanifest.lua
    • server.js
    • Paket.json

server.cfg (oder txAdmin Rezept / Startup):

# Starte nach deinen Identifikationsanbietern und vor der Beitretslogik, die davon abhängt
stelle DiscordWhitelist sicher

In txAdmin → Ressourcen, markieren DiscordWhitelist zum Starten beim Booten (wenn du Ressourcen über UI verwaltest).

Planst du deine Zugriffsstrategie? Lies unsere umfassendere Anleitung: FiveM-Whitelist – Vollständige Anleitung (txAdmin, Skripte, DB) für Alternativen (ACE, DB, Hybrid) und wann welche verwendet werden sollten.

Schritt 4 – Konfigurieren server.js

Offen Ressourcen/[Discord]/DiscordWhitelist/server.js und setze den Konfigurationsblock. Die Datei enthält möglicherweise bereits ein einfaches Konfigurationsobjekt – passe die Werte entsprechend an. Eine typische Konfiguration sieht so aus:

// Discord-Whitelist-Konfiguration — Beispiel
const config = {
 botToken: "FÜGE HIER DEINEN DISCORD-BOT-TOKEN EIN",
 guildId: "123456789012345678", // Deine Server-ID (Guild)

 // Spieler müssen mindestens EINE dieser Rollen-IDs haben, um beizutreten
 whitelistRoles: [
 "111111111111111111", // Whitelist
 // "222222222222222222", // Mitarbeiter (optional)
 ],

 // Wenn ein Spieler JEDER dieser Rollen hat, lehne die Verbindung ab
 blacklistRoles: [
 // "333333333333333333", // Gesperrt
 ],

 // Cache-Rolle-Daten, um Discord-API-Aufrufe zu reduzieren (Sekunden)
 cacheMaxTime: 90,

 // Deferral-Nachrichten
 messages: {
 noDiscord: "Öffne Discord und tritt erneut bei. Deine Discord-App muss laufen.",
 notWhitelisted: "Du bist nicht whitelisted. Tritt unserem Discord bei: discord.gg/deineeinladung",
 blacklisted: "Zugriff verweigert. Wende dich an das Personal.",
 welcome: "Willkommen — du bist verifiziert. Lade…"
 },
};

Monetarisierungstipp: Wenn dein Server Vorteile verwendet, kombiniere dies mit Discord-Spendenstufen um rollenbasierte Vorteile für Unterstützer/Spender zu automatisieren.

Speichere die Datei.

Schritt 5 – Neustart und Test

  1. Neustart nur die Ressource oder der ganze Server: txAdmin → Ressource neu starten oder Konsole Aktualisieren Dann DiscordWhitelist neu starten.
  2. Negativer Test: Versuche, eine Verbindung herzustellen ohne der Whitelist-Rolle → du solltest die Deferral-Nachricht sehen und gekickt werden.
  3. Positiver Test: Gewähre dir die Whitelist-Rolle → verbinde erneut → du solltest Zugang erhalten.

Optional: Mehrere Rollen und Mitarbeiterumgehung

  • Hinzufügen mehrere Whitelist-Rollen um mehrere Trichter zu ermöglichen (z. B. Spender, Polizei, EMS).
  • Hinzufügen Blacklist-Rollen für harte Blöcke unabhängig von der Whitelist (zB, Verboten).
  • Du kannst eine Mitarbeiterrolle In Whitelist-Rollen um den Zugriff für Administratoren zu überprüfen.

Betriebstipps

  • Automatisierung: Verbinde Discord-Rollenvergabe mit deinem Bewerbungsformulare oder Ticketgenehmigungen (z. B. mit einem Bot, Google Forms → Webhook → Rolle hinzufügen).
  • Spieler-UX: Pin a #Anleitung zur Whitelist Beitrag mit ✅ Rollenanforderungen und deiner Server-Einladung.
  • Mäßigung: Rollenänderungen in einem privaten #mod-Protokolle Kanal.

Fehlerbehebung

„Bot offline“ oder aktualisiert Rollen nie

  • Falsches Token oder Bot nicht zur richtigen Gilde eingeladen.
  • Absicht der Servermitglieder nicht aktiviert.
  • Firewall blockiert ausgehende HTTPS-Verbindungen von deinem Spielhost (erlaube Discord API).

„Keine Discord-Kennung gefunden“ / alle gesperrt

  • Spieler müssen die Discord-Desktop-App vor dem Starten von FiveM. Bitte sie, Discord neu zu starten, dann FiveM.

Rollenänderungen gelten erst nach einem Neustart

  • Reduzieren cacheMaxTime auf 30–60 Sekunden.
  • Wenn du es extrem niedrig einstellst und trotzdem Verzögerungen siehst, überprüfe die Rate Limits und vermeide häufige Neustarts.

403/Berechtigungsfehler beim Abrufen von Gildenmitgliedern

  • Stelle sicher, dass der Bot in der Ziel-Guild ist Und Server Members Intent ist aktiviert.
  • Der Bot macht nicht du brauchst Admin-Rechte, um Mitgliederrollen zu lesen.

Hohe API-Nutzung/Ratenbegrenzung

  • Zunahme cacheMaxTime. Vermeide Massen-Kicks/Neustarts, die API-Aufrufe spammen.

Best Practices für die Sicherheit

  • Speichere die Bot-Token außerhalb der Versionskontrolle. Wenn du Konfigurationen selbst hostest, überlege, sie aus einer Umgebungsvariable oder server.cfg ConVar zu lesen, nicht im Klartext in Git.
  • Drehen das Token, wenn es durchgesickert ist.
  • Beschränke, wer Schreibzugriff auf die Ressource hat.

Deinstallieren / Deaktivieren

  • Entfernen stelle DiscordWhitelist sicher aus server.cfg (oder deaktiviere in txAdmin → Ressourcen).
  • Entferne den Ordner aus Ressourcen/ wenn du es außer Betrieb nimmst.

Häufig gestellte Fragen

Müssen die Spieler Discord ausführen?
Ja. Ohne die Zwietracht: Kennung, das Skript kann die Rollen nicht überprüfen.

Welche Absichten brauche ich?
Nur Absicht der Servermitglieder.

Kann ich mehrere Whitelist-Rollen verwenden?
Ja. Der Zugriff wird gewährt, wenn der Benutzer beliebig der aufgeführten Rollen.

Kann ich bestimmte Rollen strikt ablehnen?
Ja. Füge sie hinzu BlacklistRoles.

Es funktionierte nicht mehr, nachdem ich die Rollen gewechselt hatte.
Untere cacheMaxTime, dann teste erneut. Stelle sicher, dass der Bot online ist und der richtige Token sowie der Server verwendet wird.

Gibt es eine gepflegte Version?
Ja. Eine kommerzielle, aktiv gepflegte Version existiert, falls du Updates/Support benötigst.

Anhang – Beispiel server.cfg

# Discord-Whitelist sicherstellen, dass DiscordWhitelist # (Optional) zugehörige Discord-Ressourcen hier als Block einfügen # discord_perms sicherstellen # discordrolesync sicherstellen

Anhang – Beispiel für Spielernachrichten (Aufschübe)

Halte Nachrichten kurz und handlungsorientiert:

messages: {
 noDiscord: "Öffne Discord und tritt erneut bei. Deine Discord-App muss laufen.",
 notWhitelisted: "Nicht whitelisted. Bewirb dich unter #how-to-whitelist → discord.gg/yourinvite",
 blacklisted: "Zugang verweigert. Wende dich an das Support-Team über ein Ticket.",
 welcome: "Verifiziert — Stadt wird geladen…"
}

Änderungsprotokoll (für den Herausgeber)

  • v1.1 – Natürliche interne Links zu Spendenstufen, FiveM-Whitelist-Kompletthandbuch und GitHub-Download hinzugefügt.
  • v1.0 – Erste Anleitung: Bot-Erstellung, Absichten, IDs, Installation, Konfiguration, Testen, FAQ.