Установка модов на сервер Soulmask на Linux

Материал из ARK-HOSTER.RU | Документация хостинга
Перейти к навигации Перейти к поиску

Инструкция, как поставить моды на сервер Soulmask на своём VDS с Linux. Сервер уже должен быть установлен — это описано в статье Установка игрового сервера Soulmask на Linux; пути, пользователь soulmask и служба soulmask-server взяты из неё. Все команды и снимки экрана сняты с настоящего сервера: инструкция проверена 22 ноября 2026 года на Ubuntu 24.04 с сервером Soulmask версии 1.1.9.

Моды Soulmask берут из Мастерской Steam. Скачивать их вручную не нужно: номера модов дописывают в строку запуска, и сервер сам скачивает и подключает их при каждом запуске. Учётная запись Steam для этого не нужна.

1. Узнайте номер мода

Откройте страницу мода в Мастерской Soulmask. Номер мода — число в конце адреса страницы: …/filedetails/?id=3413948812. В примере ниже — мод Cure All Plus с этим номером.

2. Допишите мод в строку запуска

Остановите сервер и перейдите под пользователя soulmask. В конец строки запуска в файле start-server.sh нужно дописать ключ -mod с номером мода в кавычках. Команда sed делает это для строки из основной статьи, следующая показывает результат:

sudo systemctl stop soulmask-server
sudo su - soulmask
sed -i 's/ -QueryPort=27015$/ -QueryPort=27015 -mod="3413948812"/' ~/soulmask-server/start-server.sh
tail -n 1 ~/soulmask-server/start-server.sh
exit
sudo systemctl start soulmask-server

Если строка запуска у вас другая, откройте файл в редакторе — nano ~/soulmask-server/start-server.sh — и допишите ключ в конец строки, начинающейся с exec, через пробел. Несколько модов перечисляют через запятую внутри одних кавычек: -mod="3413948812,1234567890".

3. Проверьте мод

Мод сервер скачивает после загрузки игры, перед запуском мира; весь запуск занимает несколько минут. Когда сервер запустился, посмотрите журнал и папку модов:

sudo grep -a -E "\[MOD\]|ApplyAllOverrides|GAME STARTED" /home/soulmask/soulmask-server/WS/Saved/Logs/WS.log | cut -c31-130
sudo ls /home/soulmask/soulmask-server/WS/Mods

Строка «[MOD]downloaded … (success)» означает, что мод скачан, «ApplyAllOverridesInPackage: 3413948812» — что он подключён, «[ GAME STARTED. ]» — что сервер готов. Если последней строки ещё нет, сервер запускается — повторите команду через минуту.

Подключённые моды сервер складывает в папку WS/Mods — по папке на мод. Имя папки сервер даёт сам, оно не совпадает с номером мода.

При проверке сервер с модом ответил на запрос снаружи, с другого компьютера: в сведениях о сервере значилось «MOD_s = 3413948812».

Обновление и удаление мода

Обновление. Сервер сверяет моды с Мастерской при каждом запуске — строки «[MOD]begin download» и «[MOD]downloaded» появляются в журнале каждый раз. Чтобы получить свежую версию мода, достаточно перезапустить сервер: sudo systemctl restart soulmask-server.

Удаление. Одного ключа для этого мало: без ключа сервер мод больше не скачивает, но файлы из оставшейся папки по-прежнему подключает. Остановите сервер, уберите номер мода из ключа -mod (если мод был один — ключ целиком) и удалите папку мода из WS/Mods:

sudo systemctl stop soulmask-server
sudo su - soulmask
nano ~/soulmask-server/start-server.sh
rm -r ~/soulmask-server/WS/Mods/ИМЯ_ПАПКИ_МОДА
exit
sudo systemctl start soulmask-server

При проверке после этого сервер запустился без модов: строк «[MOD]» в журнале не было.

Перед тем как убирать мод из уже начатого мира, сохраните копию файла мира — /home/soulmask/soulmask-server/WS/Saved/Worlds/Dedicated/Level01_Main/world.db.

Если что-то пошло не так

Что видите Причина и решение
В журнале нет строк «[MOD]» Ключ -mod не попал в строку запуска: он должен стоять в той же строке, что и StartServer.sh, через пробел от остальных ключей, а номер — в кавычках. Проверьте командой tail -n 1 из шага 2.
В журнале «[MOD]downloaded … Result: '9' k_EResultFileNotFound (file not found)» Мода с таким номером в Мастерской Soulmask нет: ошибка в номере, либо мод удалён или скрыт автором. Сервер при этом запускается, но без мода. Исправьте номер и перезапустите сервер.
Мод убран из строки запуска, а в игре он остался Папка мода осталась в WS/Mods — удалите её при остановленном сервере.
Служба не запускается после правки В строке запуска потерялась кавычка. Причина видна в журнале службы: sudo journalctl -u soulmask-server -n 30 --no-pager.

Для размещения игровых серверов рекомендуем услуги ARK-HOSTER.RU: