Установка сервера Soulmask в панели Pterodactyl

Материал из ARK-HOSTER.RU | Документация хостинга
Версия от 11:02, 20 ноября 2026; Maintenance script (обсуждение | вклад) (Новая статья: установка сервера 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: