Verbinde txAdmin mit Discord: Status & Whitelist

Was die Discord-Integration von txAdmin leistet

txAdmin ist in den aktuellen FXServer-Builds enthalten und seine native Discord-Integration kann einen Status-Embed aufrechterhalten und Discord-Mitglieder- oder Discord-Rollen-Whitelisting unterstützen. Erstelle eine dedizierte Discord-Anwendung, gewähre nur die Berechtigungen, die der Statuskanal benötigt, speichere den Bot-Token nur in txAdmin und teste die Integration zuerst in einer Nicht-Produktions-Gilde oder einem Nicht-Produktions-Kanal.

Füge den Bot-Token niemals in den Chat, Screenshots, Tickets oder server.cfg.
Erteile keine Discord Administrator-Berechtigung, wenn Kanalebenen-View-, Sende-, Einbettungs- und Historie-Berechtigungen ausreichen.
Wenn die Portal-Beschriftungen von dieser Anleitung abweichen, folge der aktuellen Installation Seite und aktuelles txAdmin Einstellungen → Discord Felder.
Drehe den Token sofort um, wenn er exponiert wird, dann aktualisiere txAdmin und teste den Status-Embed erneut.

Ziel: Aktiviere die native Discord-Integration von txAdmin für Status-Embeds und (optional) Discord-gestütztes Whitelisting.

Funktioniert mit jedem FXServer-Build, der Folgendes enthält: txAdmin. Kein Hosting oder Bot-Framework von Drittanbietern erforderlich.
Fertige FiveM-Server-Pakete für diese Einrichtung:
Super ESX Server$136.99
ESX Server Base (von RibSosay)$53.99
ESX NoPixel Server Pack für FiveM$150.00
Alle FiveM-Server-Pakete durchstöbern

Voraussetzungen

Ein laufender FiveM-Server mit txAdmin aktiviert (Einstellungen → Global zeigt, dass das Panel aktiv ist).
Erlaubnis zum Erstellen einer Discord-Anwendung in deinem Discord-Entwicklerportal.
Entwicklermodus aktiviert in deinen Discord-Benutzereinstellungen (damit du Server-/Kanal-/Rollen-IDs kopieren kannst).
Der Gilden-(Server-)ID und (optional) ein Kanal-ID wo der Bot posten darf.

Schritt 1 — Erstelle die Discord-Anwendung & den Bot

Öffne den Discord-Entwicklerportal und klicke Neue Anwendung.
Innerhalb der Anwendung gehst du zu Bot → Token zurücksetzen und kopiere die Bot-Token. Behalte es geheim.
Auf der gleichen Bot Seite, aktivieren ABSICHT DER SERVERMITGLIEDER. Speichern.

Tipp: Du brauchst die Presence- oder Message Content-Intents nicht für die eingebauten Funktionen von txAdmin.

Schritt 2 — Lade den Bot zu deinem Discord-Server ein

Im Discord Entwickler-Portal, öffne Installation. Konfiguriere dort einen Server-Installationslink; ältere Portal-Layouts können den äquivalenten OAuth2-URL-Generator anzeigen.
Bereiche: auswählen Bot Und Anwendungsbefehle (Schrägstrichbefehle).
Berechtigungen: auswählen Kanäle anzeigen, Nachrichten senden, Links einbetten, Nachrichtenverlauf lesen.
Verwende den Installationslink, um die App zuerst zu einem Test-Discord-Server hinzuzufügen, bestätige die angeforderten Bereiche und Berechtigungen und installiere sie erst dann in der Produktions-Gilde.

Halte die Berechtigungen minimal. Der Bot benötigt nur Lese-/Schreib- und Einbettungsrechte.

Schritt 3 — Verbinde den Bot in txAdmin

Öffne deine txAdmin Webpanel.
Gehe zu Einstellungen → Discord.
Umschalten Discord-Bot aktivieren.
Fülle die Felder aus:
- Bot-Token: Füge den Token aus Schritt 1 ein.
- Gilden-ID: deine Discord-Server-ID (rechtsklick auf Server-Icon → ID kopieren).
- Ankündigungskanal-ID (optional): eine Kanal-ID, unter der txAdmin Status-/Neustartbenachrichtigungen posten kann.
Speichern.

Füge den Live-Status-Embed hinzu

In deinem gewählten Discord-Kanal, tippe: /status hinzufügen
txAdmin wird eine dauerhafte Einbettung das automatisch mit Serverinformationen aktualisiert wird.

Passe das Status-Embed an (optional)

In txAdmin → Einstellungen → Discord, offen Embed JSON ändern um Titel, Beschreibung, Felder, Miniaturansichten, Schaltflächen/Links usw. zu bearbeiten.

Schritt 4 – (Optional) Discord-gestützte Whitelist in txAdmin

Du kannst den Serverzugriff durch Discord-Mitgliedschaft oder Rolle einschränken.

In txAdmin gehst du zu Einstellungen → Spielerverwaltung.
Whitelist-Modus: wähle eines aus:
- Discord-Mitglied – jeder in deinem Discord kann beitreten.
- Discord-Rolle – nur Mitglieder mit angegebenen Rollen-IDs können beitreten.
Bei Verwendung Discord-Rolle, sammle Rollen-IDs (Server-Einstellungen → Rollen → rechtsklick auf Rolle → ID kopieren).
Füge die Rollen-IDs zu den Whitelist-Einstellungen hinzu. Speichern.

Anfragen genehmigen/verwalten:

Gehe zu Spielermanager → Whitelist um Anfragen und Genehmigungen zu prüfen.

Bevorzuge rollenbasiertes Whitelisting für bessere Kontrolle. Passe deinen Discord-Rollenzuweisungs-Workflow entsprechend an.

Fehlerbehebung

Beim Speichern der Discord-Einstellungen kommt es zu einer Zeitüberschreitung → Sicherstellen ABSICHT DER SERVERMITGLIEDER ist für deinen Bot im Discord-Entwicklerportal aktiviert.
Schrägstrichbefehle (/status, /info) werden nicht angezeigt → Lade den Bot erneut mit dem Anwendungsbefehle scope; stelle sicher, dass es den Kanal sehen kann.
Status wird nicht gepostet/aktualisiert → Kanalberechtigungen überprüfen: Der Bot benötigt Kanal anzeigen, Nachrichten senden, Links einbetten, Nachrichtenverlauf lesen.
Keine Nachrichten von txAdmin → Überprüfe die Gilden-ID/Kanal-ID Werte und dass beim Kopieren von IDs der Entwicklermodus aktiviert ist.
Rauschen im Ankündigungskanal → Verlassen Ankündigungen Kanal-ID leer in Einstellungen → Discord (txAdmin postet keine Ankündigungen automatisch).

Sicherheitshinweise

Behandle die Bot-Token wie ein Passwort. Drehe es, wenn es exponiert wird.
Vermeide das Gewähren von Administrator- oder unnötigen Berechtigungen.
Beschränke den Bot auf einen einzigen Posting-Kanal, wenn möglich.

Praktische Checkliste

Verwende diesen Leitfaden als Checkliste für die Vorbereitung, bevor du einen Live-FiveM-Server änderst. Bestätige die aktuelle Server-Artifact-Version, Framework-Version, Ressourcenabhängigkeiten, Datenbankänderungen und alle clientseitigen Dateien, bevor du die Änderung vornehmen.

Sichere die betroffenen Konfigurationsdateien und Datenbanktabellen.
Wende die Änderung zuerst auf einem Testserver an.
Beobachte die Serverkonsole und die Client-F8-Konsole auf Fehler.
Überprüfe, ob die Änderung Jobs, Inventar, Fahrzeuge, Karten, Sprache, Berechtigungen oder Spielerdaten betrifft.
Dokumentiere genau die Datei, den Befehl oder die Einstellung, die du geändert hast, damit sie schnell rückgängig gemacht werden kann.

Tests vor der Produktion

Nach dem ersten Test, tritt mit einem normalen Spielerkonto bei und wiederhole den Ablauf aus der Spielerperspektive. Wenn das Thema Leistung betrifft, messe vor und nach mit der gleichen Spieleranzahl, Route und Ressourcensatz. Wenn es Admin-Tools oder Berechtigungen betrifft, überprüfe sowohl erlaubte als auch verwehrte Benutzer.

Häufige Fehler

Die meisten FiveM-Probleme entstehen durch fehlende Abhängigkeiten, veraltete Cache, falsche Ordnernamen, Framework-Inkompatibilität oder Konfigurationen, die von einem anderen Server kopiert wurden. Vermeide es, mehrere Systeme gleichzeitig zu ändern; mache eine Änderung, teste sie und fahre dann fort.

Produktionsausrollungsnotizen

Bevor du diese Anleitung auf einem Live-FiveM-Server verwendest, definiere das genaue Ergebnis, das du von der Änderung erwartest. Für 'Wie du txAdmin mit Discord verbindest', bedeutet das, zu überprüfen, welcher Ressource, Einstellung, Befehl oder Workflow betroffen ist und zu bestätigen, dass die Änderung zu deinem aktuellen Framework, deiner Artefaktversion und deinen Serverregeln passt. Halte den Rollout klein genug, damit du ihn schnell rückgängig machen kannst, falls Spieler Fehler melden.

Verwende einen Staging-Server mit dem gleichen Framework, Datenbankschema, Ressourcenreihenfolge und Schlüsselabhängigkeiten wie die Produktion. Wenn das Thema Gameplay, Berechtigungen, Visuals, Sprache, Fahrzeuge, Karten, Inventar oder Wirtschaftliches Verhalten ändert, teste mit mindestens einem Admin-Konto und einem normalen Spielerkonto. Beobachte die Serverkonsole, Client-F8-Protokolle und Ressourcen-Timing, während du den genauen Spielerablauf wiederholst, der auf dem Live-Server stattfinden wird.

Checkliste für den Rollback

Speichere die vorherige Konfigurationsdatei, den Ressourcenordner und den Datenbankzustand, bevor du etwas änderst.
Zeichne die Ressourcenversion, den Commit, die Download-Seite oder den Einstellungswert auf, den du getestet hast.
Starte nur die betroffene Ressource zuerst, wenn möglich, und starte dann den gesamten Server neu, wenn Abhängigkeiten dies erfordern.
Wenn Fehler auftreten, setze die einzelne geänderte Ressource oder Einstellung zurück, bevor du einen anderen Fix testest.

Wartungshinweise

Überprüfe diese Einrichtung erneut nach FiveM-Artifact-Updates, Framework-Updates oder größeren Ressourcenänderungen. Eine Konfiguration, die heute funktioniert, kann nach Abhängigkeitsupdates, umbenannten Exports, geänderten Ereignissen oder Datenbankmigrationen brechen. Halte Notizen mit deiner Serverdokumentation, damit zukünftige Admins verstehen, was geändert wurde, warum es geändert wurde und wie sie es erneut überprüfen können.

Laufende Überprüfung

Überprüfe, wie du txAdmin mit Discord nach großen FiveM-Artifact-Updates, Framework-Änderungen oder Ressourcen-Migrationen verbindest. Bestätige, dass der Rat noch zum aktuellen Serververhalten passt, dass jeder verlinkte Quellcode weiterhin verfügbar ist und dass die Installationsschritte noch mit den Dateien übereinstimmen, die ein Server-Besitzer tatsächlich herunterladen oder konfigurieren wird.

Bei öffentlichen Servern empfiehlt es sich, neben der Serverdokumentation ein kurzes Änderungsprotokoll zu führen. Darin sollten die getesteten Funktionen, die Änderungen, die zur Verifizierung verwendeten Accounts und die Vorgehensweise zum Zurücksetzen auf ältere Server vermerkt werden. Dies beschleunigt zukünftige Wartungsarbeiten und verhindert, dass alte Konfigurationshinweise unklar oder unsicher für die Spieler werden.

Offizielle Referenzen und finale Überprüfung

Der offiziellen txAdmin-Dokumentation listet die Discord-Status-Embed- und Whitelist-Funktionen auf. Discords Anleitung zur App-Installation Und OAuth2 und Berechtigungsverweis Erkläre aktuelle Installationslinks, Bereiche, Bot-Berechtigungen und Token-Verwaltung.

Nach dem Speichern der Discord-Einstellungen von txAdmin, überprüfe, ob der Bot nur in der beabsichtigten Gilde erscheint, das Status-Embed aktualisiert wird, ein normales Mitglied keine Admin-Aktionen ausführen kann, eine erlaubte Rolle die optionale Whitelist besteht und eine verwehrte Rolle gesperrt bleibt.

Wie du txAdmin mit Discord: Status und Whitelist verbindest