Una receta de txAdmin es un archivo YAML (recipe.yaml) que el Recipe Deployer ejecuta para instalar un servidor FiveM: descarga los recursos y luego escribe el server.cfg. Esta herramienta genera la receta desde un formulario.
Cómo usar la herramienta
Rellena nombre, versión, autor y descripción (nombre y autor: 24 caracteres máx., descripción: 256 máx.).
Elige OneSync y, si hace falta, la versión mínima de FXServer ($minFxVersion).
Añade tus repositorios de GitHub (uno por línea, «owner/repo» o «owner/repo@ref»): cada uno se descargará en resources/[local].
Enumera los recursos a iniciar (ensure) y, si hace falta, líneas extra para el server.cfg.
Guarda recipe.yaml, alójalo (por ejemplo en un repositorio de GitHub) y pega su URL en el paso de plantilla personalizada del Recipe Deployer, o pega su contenido.
Variables del desplegador
El server.cfg generado usa variables que txAdmin sustituye al final del despliegue: {{serverEndpoints}} (por defecto 0.0.0.0:30120), {{maxClients}} (48 por defecto), {{svLicense}} (clave introducida en el paso 2), {{serverName}}, {{recipeName}}, {{recipeAuthor}} y, con base de datos, {{dbConnectionString}}.
Buenas prácticas
- Fija «ref» a un commit o tag para despliegues reproducibles.
- La ejecución se detiene en la primera tarea fallida: prueba la receta en un servidor vacío.
- Nunca pongas contraseñas ni claves en la receta: usa las variables del desplegador.
Preguntas frecuentes
- ¿Qué acciones de txAdmin se generan?
- download_github, connect_database (si se activa) y write_file para el server.cfg. Para otras acciones (download_file, unzip, move_path, replace_string, query_database…), añádelas a mano según la documentación de txAdmin.
- ¿Por qué la clave de licencia no está en la receta?
- El desplegador pide la clave en el paso 2 y sustituye {{svLicense}} en el server.cfg al final: nunca debe aparecer en un archivo compartido.
- ¿Se envían mis datos?
- No, todo se queda en tu navegador (localStorage).
