Una ricetta txAdmin è un file YAML (recipe.yaml) che il Recipe Deployer esegue per installare un server FiveM: scarica le risorse e poi scrive il server.cfg. Questo strumento genera la ricetta da un modulo.
Come usare lo strumento
Compila nome, versione, autore e descrizione (nome e autore: max 24 caratteri, descrizione: max 256).
Scegli OneSync e, se serve, la versione minima di FXServer ($minFxVersion).
Aggiungi i tuoi repository GitHub (uno per riga, «owner/repo» o «owner/repo@ref»): ognuno viene scaricato in resources/[local].
Elenca le risorse da avviare (ensure) e, se serve, righe extra per il server.cfg.
Salva recipe.yaml, ospitalo (ad esempio in un repository GitHub) e incolla l'URL nel passaggio del template personalizzato del Recipe Deployer, oppure incolla il contenuto.
Variabili del deployer
Il server.cfg generato usa variabili che txAdmin sostituisce a fine deploy: {{serverEndpoints}} (predefinito 0.0.0.0:30120), {{maxClients}} (predefinito 48), {{svLicense}} (chiave inserita al passo 2), {{serverName}}, {{recipeName}}, {{recipeAuthor}} e, con database, {{dbConnectionString}}.
Buone pratiche
- Fissa «ref» su un commit o tag per deploy riproducibili.
- L'esecuzione si ferma al primo task fallito: testa la ricetta su un server vuoto.
- Non inserire mai password o chiavi nella ricetta: usa le variabili del deployer.
Domande frequenti
- Quali azioni txAdmin vengono generate?
- download_github, connect_database (se attivato) e write_file per il server.cfg. Per le altre azioni (download_file, unzip, move_path, replace_string, query_database…), aggiungile a mano seguendo la documentazione di txAdmin.
- Perché la chiave di licenza non è nella ricetta?
- Il deployer chiede la chiave al passo 2 e sostituisce {{svLicense}} nel server.cfg alla fine: non deve mai comparire in un file condiviso.
- I miei dati vengono inviati?
- No, tutto resta nel browser (localStorage).
