txAdmin Setup und Rezepte: Stelle einen FiveM-Server Schritt für Schritt bereit

Du hast die FiveM-Server-Artifacts heruntergeladen, sie gestartet und jetzt fragt txAdmin nach einem PIN, einem Konto und einer Vorlage. Diese Anleitung führt dich durch den ersten Start, das Verlinken deines Cfx.re-Kontos, das Auswählen eines Rezepts und was während des Deploys passiert.

#Erster Start und der PIN

Auf Windows, führe FXServer.exe aus. Unter Linux, starte das run.sh aus den Artifacts. Der erste Start druckt eine txAdmin-URL und einen einmaligen PIN in die Konsole. Öffne die URL in deinem Browser und gib den PIN ein. Nur die Person, die die Serverkonsole lesen kann, kann das tun, was der Punkt ist.

Der PIN funktioniert nur einmal. Wenn du ihn verlierst, stoppe den Server und starte ihn erneut, um einen neuen zu bekommen, solange du das Konto-Setup nicht abgeschlossen hast. Wenn du das bereits getan hast und deinen Login vergessen hast, siehe txAdmin vergessenes Passwort.

#Verlinke dein Cfx.re-Konto

txAdmin fragt dich, ein Master-Konto zu erstellen. Du verlinkst es mit deinem Cfx.re-Konto, das das gleiche Konto ist, das du auf dem FiveM-Forum und im Cfx.re-Portal verwendest. Melde dich mit Cfx.re an, wenn gefragt, dann wähle ein Backup-Passwort für das Konto, damit du dich noch anmelden kannst, wenn der Cfx.re-Login ausfällt.

Behalte dieses Passwort irgendwohin Sicherem. Du wirst später andere Admins von der txAdmin-Admin-Seite hinzufügen, jeder mit seinen eigenen Berechtigungen.

#Server-Name und Deploy-Typ

Der Setup-Assistent fragt nach einem Servernamen, dann nach dem Deploy-Typ. Die Formulierung ändert sich zwischen txAdmin-Versionen, aber du wirst Auswahlmöglichkeiten wie diese sehen:

• Beliebte Rezepte: vorgefertigte Vorlagen, einschließlich ESX Legacy, QBCore und QBox.
• Remote-URL-Vorlage: ein Rezept, das du aus einem Link einfügst, zum Beispiel eines aus dem Konto-Archiv eines Frameworks.
• Lokale Vorlage oder benutzerdefiniertes Rezept: deine eigene Rezeptdatei.
• Bestehende Server-Daten: du hast bereits einen Server-Datenordner mit einer server.cfg und möchtest, dass txAdmin ihn ausführt.

Wenn dies ein neuer Server ist, wähle ein beliebtes Rezept. Frameworks aktualisieren ihre Rezepte, daher bekommst du ein aktuelles Setup ohne Jagd nach Download-Links.

#Wähle eine Vorlage

Nicht sicher? Lese Installiere ESX Legacy, Installiere QBCore-Server und Installiere QBox-Server, bevor du wählst, weil das Verschieben von Frameworks später das Konvertieren deiner Daten bedeutet.

#Ordner und Rezept-Parameter

Nachdem du ein Rezept wählst, zeigt txAdmin den Server-Datenordner. Dies ist, wo der Deploy server.cfg und den resources-Ordner setzt. Behalte ihn außerhalb des Artifacts-Ordners, damit du die Artifacts aktualisieren kannst, ohne deine Daten zu berühren (siehe Update FiveM Server Artifacts).

Dann kommt ein Formular mit den Parametern des Rezepts. Typische Felder:

• Cfx.re-Lizenzschlüssel: Der Schlüssel, den dein Server zum Starten braucht. Generiere ihn im Cfx.re-Portal. Wenn du einen Fehler dazu bekommst, lese den Server-Lizenzschlüssel-Fehler.
• Datenbankeinstellungen: Host, Benutzer, Passwort und Datenbankname.
• Maximale Spieler, Servernamen und andere Optionen, die das Rezept anbietet.

Achtung: Der Lizenzschlüssel ist privat. Poste nicht server.cfg in Screenshots oder Discord-Nachrichten, ohne ihn zu verbergen.

#Datenbankzugang während des Deploys

Frameworks behalten Spieler, Geld, Fahrzeuge und mehr in einer MySQL- oder MariaDB-Datenbank. Das Rezept braucht, sich anzumelden, um seine Tabellen zu erstellen. Du hast zwei übliche Setups:

1. Ein Datenbankserver, den du bereits ausführst (eine lokale MariaDB, XAMPP oder eine von deinem Host). Gib seinen Host, Benutzer und Passwort ein. Der Benutzer braucht Berechtigung, eine Datenbank zu erstellen.
2. Die Standard-txAdmin-Formularwerte, die einen lokalen Setup passen, wo die Datenbank auf der gleichen Maschine läuft.

Der Deploy baut die Verbindungszeichenfolge für dich, daher brauchst du sie nicht von Hand zu schreiben. In server.cfg wirst du sie als findest:

set mysql_connection_string "mysql://user:password@localhost/dbname?charset=utf8mb4"

Wenn der Server später sagt, dass er sich nicht verbinden kann, ist die Behebung in oxmysql-Verbindungsfehler.

#Was das Rezept wirklich macht

Ein Rezept ist eine Liste von Aufgaben, die txAdmin in Reihenfolge ausführt. Im Klartext:

1. Downloads Ressourcen: Das Framework, seine Ressourcen, oxmysql und andere Abhängigkeiten, normalerweise als ZIP-Dateien von GitHub.
2. Entpackt und verschiebt sie in den resources-Ordner.
3. Erstellt die Datenbank und importiert die Framework-SQL-Datei mit den eingegebenen Zugangsdaten.
4. Schreibt server.cfg: deinen Servernamen, Lizenzschlüssel, Verbindungszeichenfolge, ensure-Zeilen und Berechtigungen.

Wenn der Deploy fertig ist, zeigt txAdmin das generierte server.cfg zur Überprüfung. Dies ist der richtige Moment, um es Zeile für Zeile zu lesen: siehe server.cfg erklärt. Du kannst es bearbeiten, dann speichern und den Server starten.

#Nach dem Deploy

Starte den Server vom txAdmin-Dashboard und beobachte die Konsole. Ein gesunder Start endet mit den Ressourcen aufgelistet als gestartet und keine roten Fehler. Dann verbinde mit FiveM und überprüfe, dass du den Charakterbildschirm oder Spawn erreichst.

Wenn eine Ressource fehlschlägt, konnte Ressource nicht gestartet werden und Lesen einen Script-Fehler decken ab, was die Meldungen bedeuten. Für deine eigenen Admin-Rechte im Spiel, siehe ACE-Berechtigungen.

Tipp: Nimm eine Kopie des Server-Datenordners und ein Export der Datenbank gleich nach einem sauberen Deploy. Wenn du während des Experimentierens etwas zerbrichst, kannst du zu einem bekannten guten Zustand zurückkehren. Der Sicherungs-Leitfaden zeigt, wie.

#Checkliste