Uma receita do txAdmin é um arquivo YAML (recipe.yaml) que o Recipe Deployer executa para instalar um servidor FiveM: baixa os recursos e depois grava o server.cfg. Esta ferramenta gera a receita a partir de um formulário.
Como usar a ferramenta
Preencha nome, versão, autor e descrição (nome e autor: máx. 24 caracteres, descrição: máx. 256).
Escolha o OneSync e, se necessário, a versão mínima do FXServer ($minFxVersion).
Adicione seus repositórios do GitHub (um por linha, «owner/repo» ou «owner/repo@ref»): cada um será baixado em resources/[local].
Liste os recursos a iniciar (ensure) e, se necessário, linhas extras para o server.cfg.
Salve o recipe.yaml, hospede-o (por exemplo em um repositório do GitHub) e cole a URL na etapa de modelo personalizado do Recipe Deployer, ou cole o conteúdo.
Variáveis do deployer
O server.cfg gerado usa variáveis que o txAdmin substitui no fim da implantação: {{serverEndpoints}} (padrão 0.0.0.0:30120), {{maxClients}} (padrão 48), {{svLicense}} (chave informada na etapa 2), {{serverName}}, {{recipeName}}, {{recipeAuthor}} e, com banco de dados, {{dbConnectionString}}.
Boas práticas
- Fixe «ref» em um commit ou tag para implantações reproduzíveis.
- A execução para na primeira tarefa com falha: teste a receita em um servidor vazio.
- Nunca coloque senhas ou chaves na receita: use as variáveis do deployer.
Perguntas frequentes
- Quais ações do txAdmin são geradas?
- download_github, connect_database (se ativado) e write_file para o server.cfg. Para outras ações (download_file, unzip, move_path, replace_string, query_database…), adicione-as manualmente seguindo a documentação do txAdmin.
- Por que a chave de licença não está na receita?
- O deployer pede a chave na etapa 2 e substitui {{svLicense}} no server.cfg no final: ela nunca deve aparecer em um arquivo compartilhado.
- Meus dados são enviados?
- Não, tudo fica no seu navegador (localStorage).
