Импорт игр
Настройки игр и модификаций можно переносить между установками GameAP и брать из других панелей управления. Возможность появилась в GameAP 4.1.
Всё это находится на странице Администрирование → Игры.
Собственный формат GameAP
Формат GameAP переносит игру целиком: саму игру, все её модификации, переменные, команды запуска и команды RCON.
Экспорт
На странице Администрирование → Игры выберите игру и нажмите Экспорт. Панель отдаст
файл <код-игры>.gameap.yaml.
Через API:
GET /api/games/{code}/export
Импорт
Администрирование → Игры → Импорт GameAP YAML, загрузите файл и нажмите Импортировать.
Через API:
POST /api/games/import/gameap
Импорт создаёт игру, если её ещё нет, и обновляет существующую, если игра с таким кодом уже заведена. Модификации импортируются вместе с игрой — после загрузки панель сообщает, сколько их создано и сколько обновлено.
Что именно происходит с уже заведёнными данными:
- Игра сопоставляется по коду, модификация — по имени в пределах этой игры.
- Совпавшие записи перезаписываются значениями из файла: команды запуска, переменные, команды RCON, репозитории. Прежние значения не сохраняются.
- Исключение — служебное поле метаданных: оно сливается, а не затирается.
- Модификации, которые есть в панели, но отсутствуют в файле, не удаляются и остаются как были.
Импорт поверх настроенной игры затирает ваши правки. Перед загрузкой файла выгрузите текущую игру экспортом — это единственный способ вернуть прежние настройки, если результат не устроит.
В начале файла указана версия формата:
schema_version: "1.0"
Файл с другой версией формата панель не примет. Это же поле стоит проверить, если перенос не удался.
Импорт из других панелей
Поддерживается импорт заготовок из:
Администрирование → Игры → Импорт Pelican Egg, загрузите файл egg в формате JSON или YAML.
Через API:
POST /api/games/import/pelican-egg
Формат egg у обеих панелей общий, поэтому файлы Pterodactyl и Pelican загружаются одинаково.
Обновление игр из каталога GameAP
Панель поставляется с каталогом готовых настроек игр и модификаций. Чтобы подтянуть из него изменения, нажмите Обновить игры на странице Администрирование → Игры.
Через API:
POST /api/games/upgrade
Ваши изменения могут быть перезаписаны. Обновление приводит настройки игр и модификаций к состоянию каталога. Если вы правили команды запуска или переменные у стандартных игр, сохраните их перед обновлением — например, выгрузив игру в файл через экспорт.
Модификация не обновляется, если в панели нашлось несколько модификаций с одним именем для этой игры — такие случаи пропускаются, чтобы не перезаписать не ту.
Адреса каталога задаются переменной GAMES_CDN_URLS; они перебираются по порядку, пока один
не ответит. См. Справочник config.env.
Особенности Pelican и Pterodactyl
Работа с импортированными Pelican Eggs и Pterodactyl Eggs возможна только на Docker и Podman процесс менеджерах.
Вам необходимо сконфигурировать GameAP Daemon для работы с одним из этих процесс менеджером. Для этого при добавлении новой ноды, в разделе “Дополнительные настройки” выберите нужный процесс менеджер.
