Richte eine Discord-Rollen-Allowlist für FiveM ein

Eine Discord-Rollen-Allowlist ermöglicht es dem Personal, den Zugriff durch Zuweisung einer bestimmten Rolle zu genehmigen. Verwende den in deiner installierten txAdmin-Version integrierten Discord-Rollen-Modus und teste dann sowohl ein genehmigtes als auch ein nicht genehmigtes Konto, bevor du dich darauf verlässt.

Bereite den Zugriff und die Wiederherstellung vor

Du benötigst die Berechtigung, txAdmin und die Discord-Anwendung zu konfigurieren, sowie einen Discord-Server und eine dedizierte Genehmigungsrolle. Halte einen autorisierten txAdmin-Wiederherstellungs-Login bereit. Kombiniere nicht mehrere Allowlist-Skripte, bis du verstehst, welches eine Verbindung akzeptiert oder ablehnt.

1. Verbinde den Discord-Bot

Richte den dedizierten Bot über die Discord-Integration von txAdmin ein. Befolge die angezeigten Anforderungen der Integration für Bot-Berechtigungen und Member-Intents. Speichere das Token nur in der geschützten serverseitigen Einstellung. Wenn ein Token in einem Screenshot oder öffentlichen Repository erscheint, setze es zurück und aktualisiere die Integration.

Bestätige, dass der Bot sich mit dem beabsichtigten Discord-Server verbindet, bevor du den Zugriff konfigurierst. Kanalstatusmeldungen und Verbindungsfreigabe sind separate Funktionen; eine funktionierende Statusmeldung beweist nicht, dass die Allowlist funktioniert.

2. Kopiere die Server- und Rollen-IDs

Aktiviere den Entwicklermodus in den erweiterten Benutzereinstellungen von Discord. Kopiere die Server-ID und die ID deiner Genehmigungsrolle. Verwende IDs, nicht Anzeigenamen. Weise die Rolle einem Testmitglied zu und lasse ein anderes Mitglied ohne sie. Beschränke die Berechtigung zur Zuweisung dieser Rolle auf Mitarbeiter, die den Zugriff genehmigen dürfen.

3. Wähle den Discord-Rollen-Modus

Wähle in den Allowlist-Einstellungen von txAdmin den Modus für Discord-Rollen und gib die erforderlichen Server-/Rollen-IDs ein. Die Upstream-Konfiguration nennt diesen Modus discordRoles; verwende die von deiner installierten Version bereitgestellte Oberfläche, anstatt nicht verwandte Ressourcendateien zu bearbeiten. Speichere die Einstellung und befolge alle angezeigten Neustartanweisungen.

Schreibe eine kurze Ablehnungsnachricht, die erklärt, wo man sich bewerben und wie man Hilfe erhalten kann. Vermeide es, interne Mitarbeiterkanäle, Token oder persönliche Identifikatoren in Verbindungsnachrichten preiszugeben.

4. Teste die vollständige Entscheidung

1. Verbinde dich mit dem Mitglied, das die Genehmigungsrolle hat. Bestätige, dass der Server die Verbindung akzeptiert.
2. Verbinde dich mit dem Mitglied, das die Rolle nicht hat. Bestätige die Ablehnung und eine nützliche Nachricht.
3. Entferne die Rolle vom genehmigten Mitglied, warte das dokumentierte Aktualisierungsverhalten der Integration ab, verbinde dich dann erneut und bestätige die Ablehnung.
4. Weise die Rolle neu zu und verbinde dich erneut. Überprüfe den genehmigten Fall erneut.
5. Überprüfe Protokolle und Wiederherstellungsverhalten, wenn die Discord-Mitgliedschaft nicht aufgelöst werden kann. Gehe nicht davon aus, dass ein Abhängigkeitsfehler das gewünschte Zugriffsverhalten hat.

Behebe die fehlgeschlagene Grenze

Wenn der Bot keine Verbindung herstellen kann, überprüfe das Token, die ausgewählte Anwendung und das txAdmin-Protokoll. Wenn nur Rollenprüfungen fehlschlagen, überprüfe die Guild-ID, die Rollen-ID, die tatsächliche Mitgliedschaft und den konfigurierten Modus. Befolge die aktuellen Anweisungen von txAdmin zur Discord-Identitätserkennung; ein fehlender Bezeichner sollte eine umsetzbare Ablehnung erzeugen.

Vergib keine Administratorberechtigung und starte nicht wiederholt neu, anstatt die Fehlermeldung zu lesen. Wenn eine separate Allowlist-Ressource installiert ist, deaktiviere die widersprüchliche Regel nur im Rahmen einer kontrollierten Wartungsänderung und prüfe den Zugriff erneut.

Pflege die Regel

Dokumentiere, wer die Rolle vergibt, wie Beschwerden behandelt werden und wie der Zugriff entzogen wird. Überprüfe Bot- und Mitarbeiterberechtigungen, wenn Administratoren wechseln. Eine Rolle, die Gameplay erlaubt, sollte nicht automatisch txAdmin-Administrationsrechte gewähren.

Referenzdokumentation

Quelle: raw.githubusercontent.com · Cfx.re — txAdmin · Quelle: docs.discord.com