Une recette txAdmin est un fichier YAML (recipe.yaml) que le Recipe Deployer exécute pour installer un serveur FiveM : il télécharge les ressources puis écrit le server.cfg. Cet outil génère la recette à partir d'un formulaire.
Comment utiliser l'outil
Renseignez le nom, la version, l'auteur et la description (nom et auteur : 24 caractères max, description : 256 max).
Choisissez OneSync et, si besoin, la version minimale de FXServer ($minFxVersion).
Ajoutez vos dépôts GitHub (un par ligne, « owner/repo » ou « owner/repo@ref ») : chacun sera téléchargé dans resources/[local].
Listez les ressources à démarrer (ensure) et, si nécessaire, des lignes supplémentaires pour le server.cfg.
Enregistrez recipe.yaml, hébergez-le (par ex. dans un dépôt GitHub) puis collez son URL dans l'étape « Custom Template » du Recipe Deployer, ou collez son contenu.
Variables du déployeur
Le server.cfg généré utilise les variables remplacées par txAdmin à la fin du déploiement : {{serverEndpoints}} (par défaut 0.0.0.0:30120), {{maxClients}} (48 par défaut), {{svLicense}} (clé saisie à l'étape 2), {{serverName}}, {{recipeName}}, {{recipeAuthor}} et, avec une base de données, {{dbConnectionString}}.
Bonnes pratiques
- Fixez « ref » sur un commit ou un tag pour des déploiements reproductibles.
- L'exécution s'arrête à la première tâche en échec : testez la recette sur un serveur vide.
- Ne mettez jamais de mot de passe ni de clé dans la recette : utilisez les variables du déployeur.
Questions fréquentes
- Quelles actions txAdmin sont générées ?
- download_github, connect_database (si activé) et write_file pour le server.cfg. Pour les autres actions (download_file, unzip, move_path, replace_string, query_database…), ajoutez-les à la main d'après la documentation txAdmin.
- Pourquoi la clé de licence n'est-elle pas dans la recette ?
- Le déployeur demande la clé à l'étape 2 et remplace {{svLicense}} dans le server.cfg à la fin : elle ne doit jamais figurer dans un fichier partagé.
- Mes données sont-elles envoyées ?
- Non, tout reste dans votre navigateur (localStorage).
