Ein txAdmin-Recipe ist eine YAML-Datei (recipe.yaml), die der Recipe Deployer ausführt, um einen FiveM-Server einzurichten: Er lädt Ressourcen herunter und schreibt dann die server.cfg. Dieses Tool erzeugt das Recipe aus einem Formular.
So verwenden Sie das Tool
Tragen Sie Name, Version, Autor und Beschreibung ein (Name und Autor: max. 24 Zeichen, Beschreibung: max. 256).
Wählen Sie OneSync und bei Bedarf die minimale FXServer-Version ($minFxVersion).
Fügen Sie Ihre GitHub-Repositories hinzu (eins pro Zeile, „owner/repo“ oder „owner/repo@ref“): Jedes wird nach resources/[local] geladen.
Listen Sie die zu startenden Ressourcen (ensure) und bei Bedarf zusätzliche Zeilen für die server.cfg auf.
Speichern Sie recipe.yaml, hosten Sie es (z. B. in einem GitHub-Repository) und fügen Sie die URL im Custom-Template-Schritt des Recipe Deployers ein – oder den Inhalt direkt.
Deployer-Variablen
Die erzeugte server.cfg nutzt Variablen, die txAdmin am Ende des Deployments ersetzt: {{serverEndpoints}} (Standard 0.0.0.0:30120), {{maxClients}} (Standard 48), {{svLicense}} (in Schritt 2 eingegebener Schlüssel), {{serverName}}, {{recipeName}}, {{recipeAuthor}} und bei Datenbank {{dbConnectionString}}.
Empfehlungen
- Setzen Sie „ref“ auf einen Commit oder Tag für reproduzierbare Deployments.
- Die Ausführung stoppt bei der ersten fehlgeschlagenen Aufgabe: Testen Sie das Recipe auf einem leeren Server.
- Legen Sie nie Passwörter oder Schlüssel im Recipe ab: Nutzen Sie die Deployer-Variablen.
Häufige Fragen
- Welche txAdmin-Aktionen werden erzeugt?
- download_github, connect_database (falls aktiviert) und write_file für die server.cfg. Weitere Aktionen (download_file, unzip, move_path, replace_string, query_database …) ergänzen Sie von Hand laut txAdmin-Dokumentation.
- Warum steht der Lizenzschlüssel nicht im Recipe?
- Der Deployer fragt den Schlüssel in Schritt 2 ab und ersetzt am Ende {{svLicense}} in der server.cfg: Er darf nie in einer geteilten Datei stehen.
- Werden meine Daten hochgeladen?
- Nein, alles bleibt in Ihrem Browser (localStorage).
