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

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

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

Моды Project Zomboid берут из Мастерской Steam. Скачивать файлы вручную не нужно: достаточно вписать номера модов в файл настроек, и сервер сам скачает их при запуске. Игрокам ставить моды вручную тоже не нужно — игра скачивает их из Мастерской при входе на сервер.

1. Узнайте два идентификатора мода

У каждого мода их два, и серверу нужны оба:

Идентификатор Что это Где взять
Workshop ID Номер страницы мода в Мастерской. По нему сервер скачивает файлы Число в конце адреса страницы мода: …/filedetails/?id=2544353492. Оно же стоит внизу описания, строкой «Workshop ID: …»
Mod ID Внутреннее имя мода. По нему сервер включает мод Указан внизу описания мода в Мастерской, строкой «Mod ID: …»

Для примера взят мод Has Been Read — он помечает уже прочитанные книги. Его Workshop ID — 2544353492, Mod ID — P4HasBeenRead.

На странице мода посмотрите метки версии игры: мод должен подходить к сборке вашего сервера (Build 41 или Build 42). В одном моде Мастерской бывает несколько Mod ID — отдельные части или варианты; автор пишет в описании, какие из них включать.

2. Впишите мод в файл настроек

Настройки сервера лежат в файле /home/zomboid/Zomboid/Server/servertest.ini. В нём нужны две строки: Mods= — для Mod ID и WorkshopItems= — для Workshop ID. Остановите сервер, впишите оба значения и запустите его снова:

sudo systemctl stop zomboid-server
sudo -u zomboid sed -i 's/^Mods=.*/Mods=P4HasBeenRead/; s/^WorkshopItems=.*/WorkshopItems=2544353492/' /home/zomboid/Zomboid/Server/servertest.ini
sudo grep -E '^(Mods|WorkshopItems)=' /home/zomboid/Zomboid/Server/servertest.ini
sudo systemctl start zomboid-server

Те же строки можно поправить в редакторе: sudo -u zomboid nano /home/zomboid/Zomboid/Server/servertest.ini. Несколько модов перечисляют через точку с запятой, без пробелов:

Mods=P4HasBeenRead;ВторойМод;ТретийМод
WorkshopItems=2544353492;1111111111;2222222222

Порядок в строке Mods= — это порядок загрузки модов: если мод зависит от другого, тот должен стоять раньше.

Для мода с картой заполняют ещё и строку Map=: имя папки карты из мода ставят перед Muldraugh, KY, через точку с запятой.

3. Проверьте, что мод загрузился

При первом запуске с модом сервер скачивает его и включает — в журнале службы появляются строки:

Workshop: onItemDownloaded itemID=2544353492 time=3506 ms
Workshop: 2544353492 installed to /home/zomboid/zomboid-server/steamapps/workshop/content/108600/2544353492
LOG  : Mod … loading P4HasBeenRead
*** SERVER STARTED ****

Скачанные моды лежат в папке steamapps/workshop/content/108600 внутри папки сервера — по папке на каждый Workshop ID. В каждой есть файл mod.info, и в нём строкой id= записан Mod ID:

sudo ls /home/zomboid/zomboid-server/steamapps/workshop/content/108600
sudo find /home/zomboid/zomboid-server/steamapps/workshop/content/108600 -name mod.info | head -n 3

При проверке сервер с модом ответил на запрос снаружи, с другого компьютера: в сведениях о сервере значилось «modCount = 1, mods = P4HasBeenRead». Игроки видят список модов сервера в игре, в окне сведений о сервере.

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

Сервер проверяет Мастерскую при каждом запуске и скачивает свежие версии модов. Когда автор обновил мод, игроки с новой версией не смогут войти на сервер со старой — перезапустите сервер:

sudo systemctl restart zomboid-server

Что сервер сделал с модами при последнем запуске, показывает журнал службы — эта команда выводит строки только текущего запуска:

sudo journalctl -u zomboid-server -o cat --since "$(systemctl show zomboid-server -p ActiveEnterTimestamp --value | cut -d' ' -f2,3)" | grep -E "Workshop: |loading P4|SERVER STARTED" | cut -c1-105

Строки «GetItemState()=Installed» и «item state CheckItemState -> Ready» означают, что мод уже скачан и свежий. В образце loading P4 подставьте начало Mod ID своего мода.

Удаление модов

Остановите сервер, уберите мод из обеих строк и удалите его папку — сам сервер скачанные файлы не удаляет:

sudo systemctl stop zomboid-server
sudo -u zomboid sed -i 's/^Mods=.*/Mods=/; s/^WorkshopItems=.*/WorkshopItems=/' /home/zomboid/Zomboid/Server/servertest.ini
sudo rm -r /home/zomboid/zomboid-server/steamapps/workshop/content/108600/2544353492
sudo systemctl start zomboid-server

Команда sed из примера очищает строки целиком. Если модов несколько, уберите из строк только нужный — в редакторе. При проверке после этого сервер запустился без мода: в сведениях о сервере стало «modCount = 0».

Перед тем как добавлять или убирать моды на сервере с готовым миром, сделайте копию папки /home/zomboid/Zomboid/Saves: мир, сохранённый с модом, без него может потерять предметы и постройки этого мода.

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

Что видите Причина и решение
Мод скачался, но строки «loading …» с его именем в журнале нет В строке Mods= вписан не Mod ID, а номер или название мода, либо в имени ошибка. Точное имя — в описании мода и в файле mod.info внутри его папки, строка id=.
Строки «Workshop: … installed» нет, папка мода не появилась В строке WorkshopItems= неверный номер, либо правку сделали при работающем сервере и он записал файл поверх. Остановите сервер и проверьте обе строки.
При загрузке мода в журнале строки «NoSuchFileException … media/AnimSets» Сервер ищет в моде папки, которых в нём нет. Это не ошибка мода: при проверке сервер с такими строками запустился и мод работал.
Сервер с модом не доходит до «SERVER STARTED» Мод не подходит к версии игры или ему нужен другой мод — он указан на странице мода в Мастерской, в блоке зависимостей справа. Добавьте его в обе строки, либо уберите мод.
Игрока не пускает на сервер после обновления мода У сервера осталась старая версия. Перезапустите его: sudo systemctl restart zomboid-server.

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