Um txAdmin mit Discord zu verbinden, erstelle eine dedizierte Discord-Anwendung und einen Bot, lade ihn mit nur den benötigten Berechtigungen auf den richtigen Server ein, kopiere das Bot-Token in die Discord-Einstellungen von txAdmin und konfiguriere Statusmeldungen und rollenbasierten Zugriff als separate Funktionen. Halte das Token privat: Es authentifiziert den Bot und sollte niemals in Screenshots, Client-Dateien oder einem öffentlichen Repository erscheinen.
Trenne die vier beweglichen Teile
| Teil | Zweck | Typischer Fehler |
|---|---|---|
| Discord-Anwendung und Bot | Identität, die von txAdmin verwendet wird | Falsche Anwendung, deaktivierter Bot oder neu generiertes Token |
| Serverstatus | Veröffentlicht oder aktualisiert den Status in einem ausgewählten Kanal | Falscher Kanal oder fehlende Anzeige-/Sende-/Einbettungsberechtigungen |
| Rollen oder Whitelist | Ordnet Discord-Mitgliedschaft/Rollen der konfigurierten Zugriffsregel zu | Falsche Server-/Rollen-ID, Rollenhierarchie oder Anforderungen an den Member Intent |
| txAdmin-Berechtigungen | Steuert, wer den FiveM-Server verwalten darf | Irrtümliche Annahme, eine Discord-Rolle gewähre automatisch txAdmin-Rechte |
Debugge diese nicht als eine Funktion. Beweise zuerst, dass der Bot online ist, dann beweise, dass er auf einen Kanal zugreifen kann, füge dann das Statusverhalten hinzu und teste erst dann optionale Rollen- oder Whitelist-Logik.
Schritt 1: Erstelle eine dedizierte Discord-Anwendung
- Öffne das Discord-Entwicklerportal und erstelle eine neue Anwendung für diesen Server.
- Füge der Anwendung einen Bot hinzu.
- Gib ihm einen klaren Namen, damit das Personal Produktion von Staging unterscheiden kann.
- Generiere oder setze das Token nur zurück, wenn du bereit bist, es sicher zu speichern.
Ein Bot-Token ist ein Geheimnis, keine Anwendungs-ID oder ein öffentlicher Schlüssel. Wenn es offengelegt wird, setze es in Discord zurück und aktualisiere txAdmin sofort. Speichere den Ersatz nur in der serverseitigen Einstellung, die für das Token vorgesehen ist.
Schritt 2: Lade den Bot mit minimalen Berechtigungen ein
Verwende den OAuth2-Installationsfluss von Discord für die Anwendung und wähle den Bot-Bereich, der für das aktuelle Setup erforderlich ist. Beginne mit den kleinsten Kanalberechtigungen, die die Funktion erfüllen: den ausgewählten Kanal anzeigen, Nachrichten senden, Links einbetten und den Nachrichtenverlauf lesen, wo die Statusaktualisierung dies erfordert. Vermeide Administrator, es sei denn, die offizielle Integration erfordert es explizit und du hast überprüft, warum.
Beschränke den Bot nach Möglichkeit auf einen dedizierten Status- oder Verwaltungskanal. Bestätige nach dem Einladen, dass er im vorgesehenen Discord-Server auftaucht. Dass er als offline angezeigt wird, ist zu erwarten, bis txAdmin sich erfolgreich mit dem Token anmeldet.
Schritt 3: Konfiguriere den Bot in txAdmin
Öffne txAdmin als autorisierter Administrator und suche die Discord-Integrations-Einstellungen in deiner installierten Version. Füge das Token ohne Anführungszeichen oder zusätzliche Leerzeichen in das Token-Feld ein. Wähle den gewünschten Discord-Server und Kanal über die von txAdmin bereitgestellten Eingabefelder aus. Speichere und starte dann nur die Komponente oder den Server neu, wenn die Benutzeroberfläche dies anfordert.
Wenn du die FiveM-Seite von Grund auf neu aufbaust, verwende zuerst den FiveM Server-Setup-Pfad . Discord kann weder einen fehlerhaften FXServer noch eine unerreichbare txAdmin-Instanz reparieren.
Statusmeldungen separat konfigurieren
Aktiviere die Statusfunktion und wähle einen Kanal, in den der Bot posten kann. Beginne mit einer einfachen Testaktualisierung, bevor du benutzerdefinierte Formulierungen oder Einbettungen hinzufügst. Bestätige, dass sich die Nachricht ändert, wenn der FiveM-Server startet, stoppt oder die Spieleranzahl ändert, gemäß dem von deiner txAdmin-Version dokumentierten Verhalten.
Wenn der Bot sich anmeldet, aber kein Status angezeigt wird, überprüfe die ausgewählte Kanal-ID und die kanalspezifischen Überschreibungen. Eine serverweite Rolle kann das Senden erlauben, während eine Kanalüberschreibung es verweigert. Überprüfe auch die Konsolen-/Log-Ausgabe von txAdmin auf die Discord-API-Antwort, anstatt das Token wiederholt neu zu generieren.
Rollen oder Whitelist-Regeln separat konfigurieren
Rollenbasierter Zugriff erfordert die genauen Discord-Server- und Rollen-Identifikatoren, die von der Integration erwartet werden. Aktiviere den Entwicklermodus von Discord, um IDs zu kopieren, wenn die aktuelle Einrichtung danach fragt. Rollennamen sind keine stabilen Identifikatoren, und zwei Rollen können einen ähnlichen Namen haben.
Teste mit einem Konto, das die erforderliche Rolle hat, und einem, das sie nicht hat. Entferne und füge die Rolle erneut hinzu, verbinde dich wieder und bestätige, wann die Integration die Mitgliedschaft aktualisiert. Gehe nicht davon aus, dass eine Discord-Rolle automatisch txAdmin-Administratorberechtigungen gewährt; das eigene Berechtigungsmodell von txAdmin bleibt eine separate Kontrolle, es sei denn, die dokumentierte Funktion ordnet sie explizit zu.
Schütze das Token und die Berechtigungsgrenze
- Füge das Token niemals in den Discord-Chat, ein für andere sichtbares Support-Ticket oder eine clientseitige Ressource ein.
- Committe es nicht in Git und speichere es nicht in einem öffentlichen Screenshot.
- Beschränke den Zugriff sowohl auf die Discord Developer Portal-Anwendung als auch auf die txAdmin-Einstellungen.
- Setze das Token nach der Offenlegung zurück oder wenn ein Administrator mit Zugriff geht.
- Überprüfe regelmäßig die Server- und Kanalberechtigungen des Bots.
Fehlerbehebungs-Checkliste
| Symptom | Überprüfe |
|---|---|
| Bot bleibt offline | Token gehört zum richtigen Bot, enthält keine Leerzeichen, wurde nicht zurückgesetzt und txAdmin-Logs zeigen einen Anmeldeversuch |
| Bot ist online, kann aber nicht posten | Ausgewählter Kanal, Ansichts-/Sende-/Einbettungsberechtigungen und Kanal-Overrides |
| Status wird nie aktualisiert | Statusfunktion aktiviert, korrekter Kanal, txAdmin/FXServer-Status und Integrationsprotokoll |
| Rollenmitglied wird abgelehnt | Korrekte Server-/Rollen-ID, tatsächlich zugewiesene Rolle, Aktualisierungs-/Wiederverbindungsverhalten und erforderliche Member-Intents |
| Nicht autorisiertes Mitglied wird akzeptiert | Fallback-Zugriffsregeln, mehrere erlaubte Rollen und serverseitige Berechtigungskonfiguration |
| Es stoppte nach einem Token-Reset | txAdmin hat noch das alte Token; speichere das neue und starte bei Bedarf neu |
Abschließende Überprüfung
- Bot meldet sich nach einem sauberen Neustart ohne Token-Fehler an.
- Status wird nur im vorgesehenen Kanal gepostet.
- Die minimale Bot-Rolle kann die Nachricht ohne breitere Serverprivilegien aktualisieren.
- Der erlaubte Testbenutzer besteht die Rollen-/Whitelist-Regel.
- Der nicht erlaubte Testbenutzer scheitert an derselben Regel.
- Weder Discord-Zugriff noch ein versteckter UI-Button umgehen die eigenen Administratorberechtigungen von txAdmin.
Sobald diese Prüfungen unabhängig voneinander bestanden sind, ist die Integration einfacher zu warten: eine Bot-Identität, ein geschütztes Geheimnis, eng definierter Kanalzugriff und explizite Regeln für Status, Whitelist und Administration.
Referenzdokumentation
Cfx.re — txAdmin · Quelle: docs.discord.com · Quelle: docs.discord.com