Рецепт txAdmin — это YAML-файл (recipe.yaml), который Recipe Deployer выполняет для развёртывания сервера FiveM: скачивает ресурсы и затем записывает server.cfg. Инструмент создаёт рецепт из формы.
Как пользоваться инструментом
Заполните название, версию, автора и описание (название и автор — до 24 символов, описание — до 256).
Выберите OneSync и при необходимости минимальную версию FXServer ($minFxVersion).
Добавьте репозитории GitHub (по одному в строке, «owner/repo» или «owner/repo@ref»): каждый скачается в resources/[local].
Перечислите ресурсы для запуска (ensure) и при необходимости дополнительные строки для server.cfg.
Сохраните recipe.yaml, разместите его (например, в репозитории GitHub) и вставьте URL (или содержимое) на шаге пользовательского шаблона Recipe Deployer.
Переменные деплоера
Созданный server.cfg использует переменные, которые txAdmin подставляет в конце развёртывания: {{serverEndpoints}} (по умолчанию 0.0.0.0:30120), {{maxClients}} (по умолчанию 48), {{svLicense}} (ключ с шага 2), {{serverName}}, {{recipeName}}, {{recipeAuthor}} и, с базой данных, {{dbConnectionString}}.
Рекомендации
- Фиксируйте «ref» на коммите или теге для воспроизводимых развёртываний.
- Выполнение останавливается на первой неудачной задаче: проверьте рецепт на пустом сервере.
- Не храните пароли и ключи в рецепте: используйте переменные деплоера.
Частые вопросы
- Какие действия txAdmin создаются?
- download_github, connect_database (если включено) и write_file для server.cfg. Другие действия (download_file, unzip, move_path, replace_string, query_database…) добавляйте вручную по документации txAdmin.
- Почему лицензионного ключа нет в рецепте?
- Деплоер запрашивает ключ на шаге 2 и в конце подставляет его вместо {{svLicense}} в server.cfg: в общем файле ключа быть не должно.
- Мои данные отправляются?
- Нет, всё остаётся в браузере (localStorage).
