txAdmin: Ersteinrichtung eines FiveM-Servers

txAdmin ist ein Web-Panel zur Verwaltung eines FiveM-Servers: Es deployt den Server aus einem fertigen Rezept, überwacht ihn und startet ihn neu, und es verwaltet Admins, Bans und die Whitelist. Wir gehen den ersten Start von der PIN bis zum laufenden Server durch und erklären jedes Feld des Einrichtungsassistenten.

Wie txAdmin funktioniert#

txAdmin ist Teil jedes FiveM-Servers (FXServer), es gibt also nichts separat herunterzuladen. Wenn FXServer ohne den Parameter +exec server.cfg startet, startet statt des eigentlichen Spielservers txAdmin. txAdmin startet dann den Spielserver, überwacht ihn und startet ihn automatisch neu, wenn er abstürzt oder einfriert.

• txAdmin hält seine Daten (Admin-Konten, Einstellungen, Logs, die Spieler- und Ban-Datenbank) im Ordner txData.
• Die Weboberfläche läuft auf einem eigenen Port. Der Standardport ist 40120, auf unseren Servern kann er aber abweichen.
• Die Oberfläche ist auf Englisch. Diese Anleitung nennt die Schaltflächen genau so, wie Sie sie sehen werden.

txAdmin öffnen#

1. Öffnen Sie im Kundenbereich Meine Dienste, klicken Sie auf Ihren FiveM-Server und wechseln Sie zur Registerkarte Konsole.

2. Wenn der Server nicht läuft, klicken Sie auf Start.

3. Warten Sie auf den Kasten mit dem Text All ready! Please access:.

   All ready! Please access:
   http://your-public-ip:40120/
   
   Use the PIN below to register:
   1234

   • Die Zeile unter All ready! Please access: ist die txAdmin-Adresse. Wichtig ist der Port (die Zahl nach dem Doppelpunkt).
   • Unter Use the PIN below to register: steht eine vierstellige PIN für die erste Anmeldung. Sie wird angezeigt, bis Sie den ersten Admin anlegen.

4. Geben Sie in Ihrem Browser die Adresse http://<IP_ADRESSE>:<TXADMIN_PORT>/ ein.

   Ersetzen Sie <IP_ADRESSE> durch die IP-Adresse aus der Registerkarte Netzwerk (nur der Teil der Zeile Verbindungsadresse vor dem Doppelpunkt, zum Beispiel 203.0.113.10). Ersetzen Sie <TXADMIN_PORT> durch den Port aus dem Kasten in der Konsole. Die vollständige Adresse sieht dann etwa so aus: http://203.0.113.10:40120/.

   Wenn Sie statt der IP-Adresse einen schraffierten Balken sehen, ist der Streamer-Modus eingeschaltet. Klicken Sie oben auf Details anzeigen. Der Streamer-Modus verbirgt auch IP-Adressen in der Konsolenausgabe, einschließlich des Ports dahinter. Den txAdmin-Port können Sie dann aus der Zeile http://your-public-ip:<PORT>/ ablesen oder die Details einblenden.

   Den txAdmin-Port weisen wir noch nicht automatisch zu. Wenn Sie ihn in der Registerkarte Netzwerk (Verbindungsadresse oder Weitere Ports) nicht sehen, bitten Sie uns um einen txAdmin-Port (Kontakte). Ohne ihn öffnet sich txAdmin in Ihrem Browser nicht.

Wenn der Kasten nicht erscheint und die Konsole direkt zum Laden der Resources übergeht (Started resource …), ist txAdmin ausgeschaltet. Schalten Sie es in der Registerkarte Einstellungen › Variablen mit der txAdmin-Variable ein (1 = ein, 0 = aus) und starten Sie den Server neu. Wenn Sie keine solche Variable sehen, kontaktieren Sie uns (Kontakte).

Cfx.re-Konto verknüpfen und Passwort#

Ihre erste Anmeldung legt den Hauptadmin (Master) an. Dieser Admin hat alle Berechtigungen und ist der einzige, der nicht gelöscht werden kann.

1. Geben Sie auf der Seite No Cfx.re account linked die PIN aus der Konsole ein (Type in the PIN from the terminal.).

2. Klicken Sie auf Link Account.

3. Melden Sie sich mit Ihrem Cfx.re-Konto an und bestätigen Sie den Zugriff mit Yes, Allow.

   Sie kehren zu txAdmin zurück, zum Registrierungsformular.

4. Füllen Sie das Formular aus:

   Feld	Was eintragen	Warum
   Discord ID	Optional. Ihre numerische Discord-Benutzer-ID.	Verknüpft den Admin mit Discord (Whitelist, Befehle des txAdmin-Bots). Sie können sie später ergänzen.
   Backup Password	Ein Passwort mit 6–⁠128 Zeichen. Verwenden Sie den Passwortgenerator.	Eine Ersatzanmeldung für den Fall, dass die Cfx.re-Anmeldung nicht funktioniert.
   Confirm Password	Dasselbe Passwort noch einmal.	Fängt Tippfehler ab.

5. Akzeptieren Sie die Lizenzbedingungen (Creator PLA) und klicken Sie auf Register.

   Der Einrichtungsassistent des Servers öffnet sich.

Einrichtungsassistent des Servers#

Server Name#

Ein kurzer Servername für die txAdmin-Oberfläche und für Nachrichten im Chat und auf Discord, zum Beispiel Muj RP server. Das Feld akzeptiert höchstens 18 Zeichen. Das ist nicht der Name in der FiveM-Serverliste (der wird in der server.cfg gesetzt). Klicken Sie auf Next.

Deployment Type#

Wählen Sie für Ihren ersten Server Popular Recipes und ein Rezept:

• Basisrezept (je nach txAdmin-Version als FiveM Basic Server oder CFX Default FiveM gelistet) – ein minimaler Server ohne Framework und ohne Datenbank. Gut zum Ausprobieren und für Freeroam- und Drift-Server.
• ESX Legacy, QBCore Framework, Qbox Framework – Roleplay-Frameworks. Sie brauchen eine Datenbank. Die Unterschiede und die Auswahl behandelt ESX, QBCore oder Qbox?.

Ordner für die Serverdaten#

txAdmin schlägt vor, wohin der Server deployt wird, typischerweise txData/<NAME>_<CODE>.base. Behalten Sie den vorgeschlagenen Pfad (We strongly recommend using the path suggested below.) und klicken Sie auf Save. In diesem Ordner werden server.cfg und resources gespeichert.

Klicken Sie auf dem letzten Bildschirm (We are almost there!) auf Go to Recipe Deployer. Bereiten Sie, bevor Sie fortfahren, die Datenbank vor (nächster Abschnitt).

Datenbank vorbereiten#

Framework-Rezepte (ESX, QBCore, Qbox) brauchen eine Datenbank. Legen Sie sie im Kundenbereich an, bevor Sie in txAdmin fortfahren. Das Basisrezept braucht keine Datenbank, überspringen Sie diesen Abschnitt also, wenn Sie es verwenden.

1. Wechseln Sie im Kundenbereich zur Registerkarte Datenbank.

2. Geben Sie im Feld Datenbankname zum Beispiel fivem ein (nur Buchstaben, Zahlen und Unterstriche).

3. Lassen Sie das Feld Erlaubte Verbindungen von auf %. Das Zeichen % bedeutet „von überall“, sodass sich sowohl der Server als auch Ihr Computer mit der Datenbank verbinden können.

4. Klicken Sie auf Datenbank erstellen.

   Die Liste zeigt Datenbankname, Benutzer, Host und Passwort. Lassen Sie die Daten geöffnet; Sie kopieren sie gleich in txAdmin. Kopieren Sie den Datenbanknamen genau aus der Liste, da er von Ihrer Eingabe abweichen kann.

Rezept deployen (Server Deployer)#

Step 1: Review Recipe#

txAdmin zeigt den Inhalt des Rezepts: was es herunterlädt, wo es das speichert und welches SQL es ausführt. Führen Sie nur Rezepte aus vertrauenswürdigen Quellen aus (Only run Recipes from trusted sources!). Klicken Sie auf Next.

Step 2: Input Parameters#

Die Datenbankfelder erscheinen nach einem Klick auf Show/Hide Database options (advanced). Klicken Sie dann auf Run Recipe.

Step 3: Run Recipe#

txAdmin lädt Dateien herunter und importiert SQL. Bei großen Rezepten (QBCore, Qbox) kann das mehrere Minuten dauern. Klicken Sie danach auf Next.

Step 4: Configure server.cfg#

Sie sehen die erzeugte server.cfg. Prüfen und passen Sie jetzt drei Dinge an; alles andere erklärt server.cfg Zeile für Zeile:

• endpoint_add_tcp und endpoint_add_udp – der Port nach dem Doppelpunkt muss der Spielport aus der Zeile Verbindungsadresse in der Registerkarte Netzwerk sein (die Zahl nach dem Doppelpunkt). Wenn txAdmin den Port nicht vom Hoster erhalten hat, schreibt es den Standard 30120. Weichen sie ab, ändern Sie ihn in beiden Zeilen, sonst können sich Spieler nicht verbinden.
• sv_hostname und sets sv_projectName – der Servername in der Serverliste.
• sets locale "root-AQ" – ändern Sie es auf die Sprache Ihrer Spieler, zum Beispiel sets locale "de-DE" (oder "cs-CZ" für Tschechisch), damit die Serverliste die richtige Sprache zeigt.

Klicken Sie auf Save & Run Server. Der Server startet, und txAdmin öffnet die Live Console.

Überprüfung#

• In txAdmin zeigt die Seite Dashboard den Server als online, und in der Live Console gibt es keine roten Fehler.
• Drücken Sie im Spiel F8, geben Sie connect <IP_ADRESSE>:<PORT> ein (die Adresse aus der Zeile Verbindungsadresse in der Registerkarte Netzwerk) und verbinden Sie sich.
• Geben Sie im Spiel /tx (oder /txadmin) in den Chat ein: Das txAdmin-Menü öffnet sich. Es funktioniert nur für Admins, bei denen in txAdmin eine Cfx.re- oder Discord-ID eingetragen ist. Eine Taste für das Menü können Sie im Spiel unter Game Settings › Key Bindings › FiveM festlegen (Eintrag (txAdmin) Menu: Open Main Page).

Admins verwalten#

1. Klicken Sie im oberen Menü auf Admins.

2. Klicken Sie auf Add.

3. Füllen Sie das Formular aus:

   Feld	Was eintragen
   Username	Der Benutzername für die Anmeldung bei txAdmin. Wenn Sie Cfx.re ID ausfüllen, muss er mit dem Namen im Cfx.re-Forum übereinstimmen.
   Cfx.re ID	Optional. Der Benutzername auf forum.cfx.re (öffnet sich in einem neuen Fenster). Erlaubt die Anmeldung mit der Cfx.re-Schaltfläche und die Nutzung des /tx-Menüs im Spiel.
   Discord ID	Optional. Die numerische Discord-Benutzer-ID.
   Permissions	Haken Sie nur an, was die Person wirklich braucht (Tabelle unten).

4. Speichern Sie. txAdmin zeigt ein temporäres Passwort; senden Sie es dem Admin. Er muss es bei seiner ersten Anmeldung ändern.

Berechtigungen werden in der Datei txData/admins.json gespeichert. Ein txAdmin-Admin ist nicht automatisch Admin im Framework (ESX, QBCore). Wie Sie Berechtigungen im Framework vergeben, beschreibt ESX, QBCore oder Qbox?.

Geplante Neustarts#

Ein regelmäßiger Neustart (ein- oder zweimal täglich) gibt Speicher frei und räumt fehlerhafte Skriptzustände auf. txAdmin warnt die Spieler vorher.

1. Klicken Sie im oberen Menü auf Settings und öffnen Sie die Registerkarte FXServer.
2. Klicken Sie unter Restart Schedule auf die Schaltfläche +. Geben Sie im Dialog Add Restart Time eine Uhrzeit ein, zum Beispiel 06:00. Stattdessen können Sie auf eine fertige Vorgabe klicken (1x/day, 2x/day …).
3. Speichern Sie die Einstellungen.

Die Uhrzeit richtet sich nach der Serverzeit, nicht nach der Ihres Computers (Make sure your schedule matches your server time and not your local time.). Wenn txAdmin eine Zeitzonenwarnung anzeigt, verschieben Sie die Uhrzeit um die Differenz.

Nützliche Bereiche von txAdmin#

Fehlerbehebung#

Die txAdmin-Seite lädt nicht#

• Prüfen Sie, dass der Server läuft und die Konsole den Kasten All ready! Please access: zeigt.
• Verwenden Sie die IP-Adresse aus der Registerkarte Netzwerk und den Port aus dem Kasten. Die Adresse beginnt mit http://, nicht mit https://.
• Wenn Ihr Browser die Adresse von selbst in https:// ändert, tippen Sie sie manuell einschließlich http:// ein.
• Der txAdmin-Port muss in der Registerkarte Netzwerk zu den Ports des Servers gehören (Verbindungsadresse oder Weitere Ports). Wenn Sie ihn dort nicht sehen, kontaktieren Sie uns.

Die PIN funktioniert nicht#

Bei jedem Start wird eine neue PIN erzeugt, bis Sie den ersten Admin haben. Verwenden Sie die PIN aus der neuesten Konsolenausgabe. Sobald ein Admin existiert, wird die PIN nicht mehr angezeigt; melden Sie sich mit der Cfx.re-Schaltfläche oder mit Ihrem Passwort an.

Ich habe mein Passwort vergessen#

Melden Sie sich mit der Cfx.re-Schaltfläche an. Wenn auch das nicht funktioniert und Sie der einzige Admin sind, kontaktieren Sie uns. Das Löschen der Datei txData/admins.json versetzt txAdmin zurück zur PIN, Sie verlieren dabei aber alle Admin-Konten.

Task Failed: Response code 403 (rate limit exceeded)#

Das Rezept lädt Dutzende Repositories von GitHub herunter, und GitHub hat die Anzahl der Downloads vorübergehend begrenzt. Warten Sie etwa eine Stunde und führen Sie das Deployment erneut aus.

Das Rezept scheitert mit einem Datenbankfehler (ER_ACCESS_DENIED_ERROR, ECONNREFUSED)#

• ER_ACCESS_DENIED_ERROR – falscher Benutzer oder falsches Passwort. Kopieren Sie beides erneut aus der Registerkarte Datenbank, ohne Leerzeichen am Anfang oder Ende.
• ECONNREFUSED oder ein Timeout – falsche Adresse oder falscher Port. Database Host braucht die IP-Adresse aus dem Feld Host, nicht localhost.
• ER_BAD_DB_ERROR – der Datenbankname stimmt nicht überein. Kopieren Sie ihn genau aus der Liste der Datenbanken.

Weitere Datenbankfehler behandelt Datenbank für FiveM.

Der Server startet nach dem Deployment nicht#

Die häufigste Ursache ist ein fehlender oder falscher License Key (Could not authenticate server license key). Korrigieren Sie ihn im CFG Editor nach der Anleitung License Key. Weitere Fehler finden Sie in Häufige FiveM-Fehler.

Spieler können sich nicht verbinden, obwohl txAdmin online meldet#

Spieler verbinden sich mit dem Spielport aus der Zeile Verbindungsadresse, nicht mit dem txAdmin-Port. Prüfen Sie im CFG Editor die Zeilen endpoint_add_tcp und endpoint_add_udp: Beide müssen den Port aus der Verbindungsadresse haben, nicht den Standard 30120 aus dem Rezept (es sei denn, das ist zufällig Ihr Port). Starten Sie den Server nach der Korrektur neu. Mehr dazu in der Anleitung server.cfg.

Weiterführende Links#

• FiveM: Setting up a server using txAdmin (öffnet sich in einem neuen Fenster)
• FiveM: txAdmin und seine Berechtigungen (öffnet sich in einem neuen Fenster)
• txAdmin auf GitHub (Dokumentation zu Rezepten und Variablen) (öffnet sich in einem neuen Fenster)