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 wird von der Community gepflegt und zuletzt 2022 aktualisiert. Es funktioniert weiterhin auf vielen Servern. Es gibt eine gepflegte kommerzielle Version; wenn Sie Support/SLA benötigen, ziehen Sie diese in Betracht. Diese Anleitung behandelt die kostenlose GitHub-Version.

---

Kurz zusammengefasst

1. Erstellen Sie einen Discord Bot → aktivieren Absicht der Servermitglieder → lade es zu deinem Discord ein.
2. Kopieren Sie Ihre Gilden-(Server-)ID Und Rollen-ID(s).
3. Herunterladen: FAXES/DiscordWhitelist auf GitHub → steck es rein Ressourcen/ → konfigurieren server.js.
4. Hinzufügen Stellen Sie sicher, dass die Discord-Whitelist 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 erstellen Sie Discord-Spendenstufen

---

Warum Discord-basierte Whitelists?

• Dynamisch: Gewähren/verweigern Sie den Zugriff durch Hinzufügen/Entfernen einer Discord-Rolle – keine ACE- oder DB-Bearbeitungen.
• 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 (Sie sind Administrator/Eigentümer).
• 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 – Erstellen Sie einen Discord-Bot und aktivieren Sie Intents

1. Gehen Sie zum Discord-Entwicklerportal → Neue Anwendung → benennen Sie es (zB, FiveMX Whitelist-Bot).
2. Einen Bot hinzufügen (Bot-Registerkarte) → Token zurücksetzen → kopieren Sie die Bot-Token (Bewahren Sie es sicher auf).
3. Unter Absichten für privilegierte Gateways, aktivieren Absicht der Servermitglieder. (Eine Anwesenheitsabsicht ist nicht erforderlich.)
4. Laden Sie den Bot ein zu Ihrem Discord: OAuth2 → URL-Generator → Bereiche: Bot; Berechtigungen: minimal (außer Beitritt sind keine möglich). Verwenden Sie die generierte URL und fügen Sie sie Ihrer Gilde hinzu.

Sicherheit: Behandeln Sie den Bot Token wie ein Passwort. nicht Übertragen Sie es auf Git oder teilen Sie es in Screenshots. Rotieren Sie es, wenn es durchgesickert ist.

---

Schritt 2 – Holen Sie sich Ihre IDs (Gilde und Rollen)

• In Discord → Benutzereinstellungen → Erweitert → Entwicklermodus: AN.
• Klicken Sie mit der rechten Maustaste auf Servername → Server-ID kopieren.
• Servereinstellungen → Rollen → Klicken Sie mit der rechten Maustaste auf die Rolle, die Sie als Whitelist verwenden möchten (z. B. Auf der Whitelist) → Rollen-ID kopieren.
• (Optional) Kopieren Sie die IDs für alle Rollen, die Sie schwarze Liste (z.B, Verboten).

Halten Sie Folgendes bereit:

• 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. Extrahieren Sie es auf Ihren Server unter:
   Ressourcen/[Discord]/DiscordWhitelist
3. Stellen Sie sicher, dass der Ordner mindestens Folgendes enthält:
   • fxmanifest.lua
   • server.js
   • Paket.json

server.cfg (oder txAdmin Rezept / Startup):

# Beginnen Sie nach Ihren Kennungsanbietern und vor der davon abhängigen Join-Logik, um sicherzustellen, dass DiscordWhitelist

In txAdmin → Ressourcen, markieren DiscordWhitelist beim Booten zu starten (wenn Sie Ressourcen über die Benutzeroberfläche verwalten).

Planen Sie Ihre Zugriffsstrategie? Lesen Sie unseren umfassenderen Leitfaden: 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 legen Sie den Konfigurationsblock fest. Die Datei enthält möglicherweise bereits ein einfaches Konfigurationsobjekt. Passen Sie die Werte entsprechend an. Eine typische Konfiguration sieht folgendermaßen aus:

// DiscordWhitelist-Konfiguration – Beispiel const config = { botToken: "PASTE_YOUR_DISCORD_BOT_TOKEN_HERE", guildId: "123456789012345678", // Ihre Server-(Gilden-)ID // Spieler müssen mindestens EINE dieser Rollen-IDs haben, um beizutreten whitelistRoles: [ "1111111111111111111", // Auf der Whiteliste // "2222222222222222222", // Mitarbeiter (optional) ], // Wenn ein Spieler IRGENDEINE dieser Rollen hat, lehne die Verbindung ab blacklistRoles: [ // "333333333333333333", // Gesperrt ], // Abgerufene Rollendaten zwischenspeichern, um Discord-API-Aufrufe (Sekunden) zu reduzieren cacheMaxTime: 90, // Zurückstellungsnachrichten messages: { noDiscord: "Öffnen Sie Discord und treten Sie erneut bei. Ihre Discord-App muss laufen.", notWhitelisted: "Du bist nicht auf der Whitelist. Tritt unserem Discord bei: discord.gg/yourinvite", blacklisted: "Zugriff verweigert. Bitte kontaktiere das Personal.", welcome: "Willkommen – du bist verifiziert. Wird geladen…" }, };

Monetarisierungstipp: Wenn Ihr Server Vergünstigungen verwendet, kombinieren Sie dies mit Discord-Spendenstufen um rollenbasierte Vorteile für Unterstützer/Spender zu automatisieren.

Speichern Sie 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: Versuchen Sie eine Verbindung herzustellen ohne die Whitelist-Rolle → Sie sollten die Verschiebungsnachricht sehen und rausgeworfen werden.
3. Positiver Test: Gewähren Sie sich selbst die Whitelist-Rolle → stellen Sie die Verbindung wieder her → Sie sollten eintreten dürfen.

---

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).
• Sie können Folgendes hinzufügen: Mitarbeiterrolle In Whitelist-Rollen um den Zugriff für Administratoren zu gewährleisten.

---

Betriebstipps

• Automatisierung: Verbinden Sie die Discord-Rollenzuweisung mit Ihrem Bewerbungsformulare oder Ticketgenehmigungen (z. B. mit einem Bot, Google Forms → Webhook → Rolle hinzufügen).
• Spieler-UX: Pin a #Anleitung zur Whitelist Posten Sie mit ✅ Rollenanforderungen und Ihrer Servereinladung.
• 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.
• Die Firewall blockiert ausgehendes HTTPS von Ihrem Spielehost (erlaubt Discord-API).

„Keine Discord-Kennung gefunden“ / alle gesperrt

• Spieler müssen die Discord-Desktop-App bevor Sie FiveM starten. Bitten Sie sie, Discord und dann FiveM neu zu starten.

Rollenänderungen gelten erst nach einem Neustart

• Reduzieren cacheMaxTime auf 30–60 Sekunden.
• Wenn Sie den Wert extrem niedrig einstellen und trotzdem Verzögerungen auftreten, überprüfen Sie die Ratenbegrenzungen und vermeiden Sie häufige Neustarts.

403/Berechtigungsfehler beim Abrufen von Gildenmitgliedern

• Stellen Sie sicher, dass sich der Bot in der Zielgilde befindet Und Server Members Intent ist aktiviert.
• Der Bot macht nicht Sie benötigen Administratorrechte, um die Mitgliederrollen zu lesen.

Hohe API-Nutzung/Ratenbegrenzung

• Zunahme cacheMaxTime. Vermeiden Sie Massenkicks/Neustarts, die API-Aufrufe spammen.

---

Best Practices für die Sicherheit

• Speichern Sie die Bot-Token außerhalb der Versionskontrolle. Wenn Sie Konfigurationen selbst hosten, sollten Sie diese aus einer Umgebungsvariablen oder einer server.cfg-Convar lesen und nicht im Klartext, der an Git übergeben wird.
• Drehen das Token, wenn es durchgesickert ist.
• Beschränken Sie, wer Schreibzugriff auf die Ressource hat.

---

Deinstallieren / Deaktivieren

• Entfernen Stellen Sie sicher, dass die Discord-Whitelist aus server.cfg (oder deaktivieren Sie es in txAdmin → Ressourcen).
• Entfernen Sie den Ordner aus Ressourcen/ wenn Sie es außer Betrieb nehmen.

---

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ügen Sie sie hinzu zu BlacklistRoles.

Es funktionierte nicht mehr, nachdem ich die Rollen gewechselt hatte.
Untere cacheMaxTime, dann testen Sie erneut. Stellen Sie sicher, dass der Bot mit dem richtigen Token und der richtigen Gilde online ist.

Gibt es eine gepflegte Version?
Ja. Es gibt eine kommerzielle, aktiv gepflegte Version, falls Sie Updates/Support benötigen.

---

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)

Halten Sie Nachrichten kurz und aussagekräftig:

messages: { noDiscord: "Öffne Discord und trete erneut bei. Deine Discord-App muss laufen.", notWhitelisted: "Nicht auf der Whitelist. Bewirb dich in #how-to-whitelist → discord.gg/yourinvite", blacklisted: "Zugriff verweigert. Kontaktiere das Personal per 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.