Установка модов на сервер Project Zomboid на Linux
Инструкция, как поставить моды на сервер 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:
- VPS/VDS серверы — для небольших и средних серверов
- Выделенные серверы — для высоконагруженных игровых серверов