Установка сервера Soulmask в панели Pterodactyl
Инструкция, как установить и запустить сервер Soulmask в панели управления Pterodactyl. Сама панель уже должна быть установлена — это описано в статье Как установить и настроить панель управления игровым сервером Pterodactyl. Все снимки экрана сняты с настоящей панели: инструкция проверена 20 ноября 2026 года на Pterodactyl 1.15.2 и Wings 1.13.5 с сервером Soulmask версии 1.1.9.
Шаблон ставит выделенный сервер Soulmask через SteamCMD. Сервер бесплатный и скачивается без учётной записи Steam; игрокам нужна сама игра.
Что понадобится
- VDS с установленной панелью Pterodactyl и узлом Wings; вход в панель под учётной записью администратора.
- Память: игре нужно много памяти: пустой сервер через несколько минут после загрузки мира занимает 8–9 ГБ. Серверу в панели отведите 16 ГБ и берите VDS от 16 ГБ, а с запасом на игроков — от 24 ГБ.
- Диск: файлы сервера занимают около 2,5 ГБ, образ Docker — около 1,3 ГБ. Серверу в панели отведите 25 ГБ: мир и его резервные копии растут.
Подобрать сервер можно на странице тарифов VDS.
1. Добавьте шаблон игры
Игру в Pterodactyl описывает шаблон — «яйцо» (egg): в нём записано, какой образ Docker использовать, как скачать сервер и какой командой его запустить. Шаблона Soulmask в панели изначально нет — его берут из общего хранилища шаблонов, которое ведёт сообщество.
1. Скачайте файл шаблона на свой компьютер: откройте ссылку egg-pterodactyl-soulmask.json и сохраните страницу (Ctrl+S) под именем egg-pterodactyl-soulmask.json. Нужен именно файл со словом pterodactyl в имени: соседний файл без него предназначен для другой панели и в Pterodactyl не загрузится.
2. В панели перейдите в раздел администратора (значок с шестерёнками справа вверху) и откройте Nests. Гнездо (nest) — это папка для шаблонов. Если гнезда для дополнительных игр у вас ещё нет, нажмите Create New, введите имя — например, Games — и нажмите Save.
3. Вернитесь в Nests и нажмите Import Egg. В поле «Egg File» выберите скачанный файл, в поле «Associated Nest» — гнездо Games и нажмите Import:
Панель откроет страницу шаблона с сообщением «Successfully imported this Egg and its associated variables».
2. Выделите порты
Адрес и порты сервер получает из списка «выделений» (allocations) узла. Серверу Soulmask нужны порты:
| Порт | Протокол | Зачем |
|---|---|---|
| 8777 | UDP | Игра |
| 27015 | UDP | Запросы списка серверов Steam |
1. Откройте Nodes, щёлкните по своему узлу и перейдите на вкладку Allocation.
2. В блоке «Assign New Allocations» в поле «IP Address» выберите IP-адрес VDS, а в поле «Ports» введите 8777 и 27015 — после каждого номера нажимайте Enter. Нажмите Submit:
IP-адрес на снимках заменён примером.
3. Создайте сервер
1. Откройте Servers и нажмите Create New.
2. Заполните верхнюю часть формы:
- Server Name — название сервера в панели; игроки его не видят;
- Server Owner — начните вводить почту своей учётной записи и выберите её из списка;
- Node — ваш узел, Default Allocation — порт
8777, в поле Additional Allocation(s) —27015; - Memory —
16384(в мегабайтах), Disk Space —25000, Swap —0, CPU Limit —0, то есть без ограничения.
3. В блоке «Nest Configuration» выберите гнездо Games и шаблон Soulmask. Образ Docker и команда запуска подставятся сами, менять их не нужно:
4. В блоке «Service Variables» задайте настройки игры. Что стоит изменить:
| Поле | Что вписать |
|---|---|
| Server Name | Название сервера в списке игры |
| Max Players | Число мест на сервере — до 70. По умолчанию 60
|
| Admin Password | Пароль администратора: с ним в игре открывается панель администратора. Secret123 на снимке — пример, придумайте свой
|
| Server Password | Пароль для входа на сервер. Пустое поле — вход без пароля |
| Extra Arguments | Режим сервера: впишите -pve, чтобы игроки не могли нападать друг на друга, или -pvp
|
| Map | Level01_Main — основная карта; DLC_Level01_Main — карта дополнения «Shifting Sands», попасть на неё смогут только владельцы дополнения
|
| Save Time Interval и Backup Interval | Как часто сервер записывает изменения мира и сам файл мира на диск, в секундах. Можно не менять |
| Auto Update | Оставьте 1: сервер проверяет обновления при каждом запуске
|
Остальные поля можно оставить как есть.
5. Нажмите Create Server внизу страницы.
4. Дождитесь установки
Панель создаст сервер, а Wings начнёт установку: скачает образ Docker и файлы игры. При проверке установка заняла около минуты: файлы сервера невелики — около 2,5 ГБ.
Выйдите из раздела администратора (значок выхода справа вверху) и щёлкните по серверу в списке. Пока идёт установка, вверху страницы стоит надпись «This server is currently running its installation process and most actions are unavailable», а кнопки управления не работают:
5. Запустите сервер
Когда установка закончится, сервер запустится сам: в форме создания была отмечена настройка «Start Server when Installed». Если вы её сняли, нажмите Start. Запуск долгий: сервер загружает мир от трёх до семи минут. Сервер готов, когда в консоли появились строки «registe server soulmask session succeed» — сервер зарегистрировался в списке — и «Create Dungeon Successed». Предупреждения «LogMemory: Warning» и «LogStreaming» в журнале на работу сервера не влияют:
Кнопки Restart и Stop перезапускают и останавливают сервер; при остановке панель посылает ему штатную команду завершения, и он успевает сохранить мир. Команды сервера вводят в строку под консолью.
6. Откройте порты в файрволе
Если на VDS включён файрвол ufw, разрешите порты сервера. Выполните на VDS:
sudo ufw allow 8777/udp sudo ufw allow 27015/udp
Проверить, включён ли файрвол, можно командой sudo ufw status: ответ «Status: inactive» означает, что он выключен и порты открывать не нужно.
При проверке сервер, созданный в панели, ответил на запрос снаружи, с другого компьютера: название «ARK-HOSTER Soulmask», карта «Level01_Main». Отвечать он начал примерно через минуту после готовности.
7. Зайдите на сервер
В игре откройте список серверов и найдите сервер по названию; в общем списке он появляется через несколько минут после запуска. Подробно — в статье Как зайти на сервер Soulmask.
Права администратора. В игре откройте консоль клавишей ~ и введите gm key ВАШ_ПАРОЛЬ — пароль из поля «Admin Password». Откроется панель администратора. Подробнее — в статье Как стать администратором сервера Soulmask.
Настройки после установки
Всё, что вы задали в блоке «Service Variables», можно изменить позже — на вкладке Startup страницы сервера. Изменения вступают в силу после перезапуска сервера кнопкой Restart.
Множители и правила мира лежат в файле WS/Saved/GameplaySettings/GameXishu.json — сервер создаёт его при первом запуске. Меняйте его при остановленном сервере: нажмите Stop, на вкладке Files дойдите до файла по папкам, щёлкните по нему, измените значения, нажмите Save Content и запустите сервер:
Названия настроек записаны латиницей по-китайски. Самые нужные:
| Настройка | Что меняет |
|---|---|
ExpRatio |
Множитель опыта |
CaiJiDiaoLuoRatio |
Добыча при сборе |
FaMuDiaoLuoRatio |
Добыча при рубке деревьев |
CaiKuangDiaoLuoRatio |
Добыча руды |
ZuoWuShengZhangRatio |
Скорость роста посевов |
ZhiZuoTimeRatio |
Время изготовления предметов |
Значение 1 — как задумано разработчиками, 2 — вдвое больше.
Название, пароли, число игроков, карту и режим панель передаёт серверу в команде запуска — их меняют на вкладке Startup.
Мир — файл WS/Saved/Worlds/Dedicated/Level01_Main/world.db: постройки, персонажи, племена. Его и нужно сохранять в резервную копию — на вкладке Backups или скачав файл при остановленном сервере.
Остановка сервера. Кнопка Stop завершает сервер штатно: при проверке он за полминуты записал мир на диск и выключился. Не нажимайте кнопку второй раз, пока сервер сохраняется: повторное нажатие превращает её в Kill и обрывает запись. Команды в консоль панели этому серверу не вводят: игроками управляют из игры, через панель администратора.
Обновление сервера
При включённом «Auto Update» сервер проверяет обновления при каждом запуске: после выхода обновления игры достаточно перезапустить сервер кнопкой Restart. Мир и настройки при этом сохраняются.
Если что-то пошло не так
| Что видите | Причина и решение |
|---|---|
| Сервер долго в состоянии «Starting» | Мир загружается от трёх до семи минут — и при первом запуске, и при следующих. Дождитесь строки «session succeed» в консоли. |
| Сервер останавливается сам во время запуска или вскоре после него | Не хватает памяти: серверу нужно 8–9 ГБ уже без игроков. Проверьте, что в поле Memory стоит не меньше 16 ГБ и что столько памяти есть у самого VDS. |
| Сервера нет в списке сразу после запуска | В общий список сервер попадает через несколько минут после строки «session succeed». Проверьте, что порты 8777 и 27015 открыты в файрволе по UDP. |
Правки в GameXishu.json пропали |
Файл меняли при работающем сервере. Остановите сервер, внесите правки и запустите его. |
| Игрок видит сообщение о несовпадении версий | Перезапустите сервер, чтобы он обновился, или обновите игру у игрока. |
| При импорте шаблона панель сообщает об ошибке формата | Скачан файл для другой панели или вместо файла сохранилась веб-страница. Нужен файл egg-pterodactyl-….json, сохранённый по ссылке из шага 1.
|
| В форме создания сервера нет нужного порта | Порт не выделен или уже занят другим сервером. Проверьте вкладку Allocation узла. |
| Установка не заканчивается: надпись об установке висит часами | Wings ждёт загрузки образа Docker не дольше 15 минут; если канал медленный, загрузка обрывается, а сервер остаётся в состоянии установки. Скачайте образ на VDS вручную: sudo docker pull ghcr.io/pelican-eggs/steamcmd:debian, затем на странице сервера откройте Settings и нажмите Reinstall Server.
|
| Сервер запущен, но зайти не удаётся | Проверьте, что порты открыты в файрволе VDS и что в игре указан верный адрес и порт. |
Для размещения игровых серверов рекомендуем услуги ARK-HOSTER.RU:
- VPS/VDS серверы — для небольших и средних серверов
- Выделенные серверы — для высоконагруженных игровых серверов