Pterohost docs

Project Zomboid: установка модов Workshop на сервер

Как установить моды Steam Workshop на сервер Project Zomboid: WorkshopItems, Mods в ini-файле, поиск ID, обновление и устранение конфликтов.

Кратко: чтобы подключить мод Steam Workshop к серверу Project Zomboid, нужно прописать его Workshop ID в параметр WorkshopItems и Mod ID в параметр Mods файла servertest.ini. Оба значения разные и берутся из разных источников. Перезапуск сервера активирует загрузку модов через SteamCMD.

Project Zomboid: установка модов Workshop на сервер

Project Zomboid в 2026 году остаётся одной из самых живых выживалок с огромным сообществом мод-мейкеров. Steam Workshop для PZ содержит тысячи модов - от косметических ретекстуров и новых рецептов до глобальных переработок зомби AI и карт. Установка модов на выделенный сервер принципиально отличается от клиентской: здесь нет кнопки “подписаться” - всё делается через конфиг-файл и SteamCMD. Разобравшись один раз, ты сможешь собирать любые наборов модов и синхронизировать их с игроками автоматически.

Pterohost - хостинг серверов Project Zomboid с NVMe-дисками, DDoS-защитой и поддержкой 24/7. Сервер разворачивается за 2 минуты, без ручной настройки SteamCMD. Промокод 4START даёт -20% на первый заказ. Заказать сервер Project Zomboid

Как устроена система модов в Project Zomboid

Прежде чем лезть в конфиги, важно понять архитектуру: в PZ существуют два разных идентификатора для каждого мода.

Workshop ID - числовой идентификатор страницы мода в Steam Workshop. Именно по нему SteamCMD скачивает архив мода на сервер. Выглядит как длинное число, например 2392018172.

Mod ID - внутренний идентификатор мода внутри самого архива. Задаётся автором мода в файле mod.info как строка вида id=RisingDeadExpanded. Один Workshop-архив может содержать несколько Mod ID (если автор запаковал несколько субмодов вместе).

Оба идентификатора обязательны и прописываются в разные параметры конфигурационного файла сервера. Если прописать только один - мод либо не скачается, либо не активируется.

Где хранятся конфиги сервера

Конфигурационные файлы лежат в домашней директории пользователя, от имени которого запущен сервер:

~/.cache/Zomboid/Server/servertest.ini      # основной конфиг (Linux)
~/.cache/Zomboid/Server/servertest_SandboxVars.lua
~/.cache/Zomboid/Server/servertest_spawnpoints.lua

На Windows путь другой:

C:\Users\<Username>\Zomboid\Server\servertest.ini

Если сервер запущен через Pterohost или другую панель, путь к конфигу обычно указан в настройках запуска или доступен через файловый менеджер панели.

Как найти Workshop ID и Mod ID

Поиск Workshop ID

  1. Открой страницу мода в Steam Workshop: https://steamcommunity.com/sharedfiles/filedetails/?id=2392018172
  2. Число после ?id= - это и есть Workshop ID. В примере: 2392018172
  3. Запиши его - понадобится для параметра WorkshopItems

Поиск Mod ID

Mod ID не виден напрямую на странице Workshop. Его нужно найти одним из способов:

Способ 1 - из описания мода. Большинство авторов указывают Mod ID прямо в описании или в разделе “How to Install”. Ищи строку вида Mod ID: RisingDeadExpanded или id=.

Способ 2 - из файла mod.info. После скачивания мода файл mod.info лежит по пути:

~/.steam/steam/steamapps/workshop/content/108600/<WorkshopID>/mods/<ModName>/mod.info

Открой его и найди строку id=. Это и есть Mod ID.

Способ 3 - через PZwiki или сайт mods.pzwiki.net. Там собраны Mod ID популярных модов с актуальными данными.

Пример содержимого mod.info:

name=Rising Dead Expanded
id=RisingDeadExpanded
description=Adds new zombie types...
modversion=2.4.1
pzversion=41.78

Моды с несколькими субмодами

Некоторые крупные паки содержат несколько модов в одном Workshop-архиве. В таком случае в папке mods/ будет несколько подпапок, каждая со своим mod.info. Например, пак “Brita’s Weapon Pack”:

Workshop ID: 2200148440
Mod IDs: BritasWeaponPack, BritasArmor

В конфиге нужно прописать оба Mod ID через точку с запятой.

Редактирование servertest.ini

Открой файл servertest.ini любым текстовым редактором. Найди и отредактируй две ключевые строки:

Параметр WorkshopItems

WorkshopItems=2392018172;2200148440;2553501909

Это список Workshop ID, разделённых точкой с запятой (;). По этому списку SteamCMD скачивает моды при запуске сервера.

Важные правила:

  • Разделитель строго ; без пробелов вокруг него
  • Нет финальной точки с запятой в конце строки
  • Порядок здесь не влияет на загрузку

Параметр Mods

Mods=RisingDeadExpanded;BritasWeaponPack;BritasArmor;HordeMod

Это список Mod ID (внутренних идентификаторов), тоже через ;. Именно этот параметр определяет, какие моды будут активированы в игре. Без записи Mod ID в этот параметр мод скачается на сервер, но не запустится.

Полный пример с тремя модами

# Список модов для загрузки через Steam Workshop
WorkshopItems=2392018172;2200148440;2553501909

# Список активных модов (Mod ID из mod.info каждого мода)
Mods=RisingDeadExpanded;BritasWeaponPack;BritasArmor;HordeMod

Количество записей в WorkshopItems и Mods может не совпадать - если один Workshop-пак содержит несколько Mod ID.

Порядок загрузки модов и зависимости

Project Zomboid загружает моды в том порядке, в котором они перечислены в параметре Mods. Это важно при наличии зависимостей.

Правило зависимостей

Если мод B зависит от мода A (требует его как базу), то в строке Mods мод A должен стоять РАНЬШЕ мода B:

Mods=BaseModLib;AdvancedZombies;WeaponPackRequiresBase
#         ^               ^                    ^
#     зависимость    зависит от BaseModLib   зависит от BaseModLib

Файл mod.info зависимых модов обычно содержит поле require=BaseModLib. Если порядок нарушен - сервер выдаст ошибку в логах о ненайденной зависимости.

Как проверить зависимости

  1. Открой mod.info каждого мода
  2. Найди строку require= - там перечислены Mod ID, которые должны быть загружены первыми
  3. Расположи моды в Mods так, чтобы базовые шли раньше зависимых

Синхронизация модов с клиентами

Когда игрок подключается к серверу с модами, PZ автоматически проверяет наличие нужных модов у клиента и предлагает скачать недостающие через Steam. Это происходит прозрачно при наличии у клиента подписки на Workshop.

Что получает клиент при подключении

  • Список Workshop ID активных модов на сервере
  • Если мода нет у клиента - предложение скачать из Workshop
  • Если версия мода у клиента устарела - предупреждение (не всегда блокирует вход, зависит от настройки)

Параметры синхронизации в servertest.ini

# Требовать одинаковую версию мода у клиента и сервера
RequireSameModsOnServer=true

# Показывать клиенту список активных модов при подключении
DisplayUserName=true

Параметр RequireSameModsOnServer=true блокирует подключение игрока, если его набор модов не совпадает с серверным. Это рекомендуется для стабильных серверов, чтобы избежать десинхронизации.

Рекомендация для игроков

Чтобы ускорить первое подключение, поделись со своими игроками списком Workshop ID и попроси подписаться на моды заранее. Это избавит от длительной загрузки в момент входа.

Обновление модов на сервере

Авторы модов выпускают обновления, и сервер не обновляет их автоматически в большинстве конфигураций. Вот как обновить моды вручную.

Метод 1 - удаление кэша Workshop

# Остановить сервер
systemctl stop pzserver   # или через панель управления

# Удалить кэш конкретного мода (по Workshop ID)
rm -rf ~/.steam/steam/steamapps/workshop/content/108600/2392018172

# Запустить сервер - SteamCMD скачает актуальную версию
systemctl start pzserver

Для обновления всех модов сразу:

rm -rf ~/.steam/steam/steamapps/workshop/content/108600/*

Метод 2 - через SteamCMD напрямую

steamcmd +login anonymous +app_update 380870 +quit

Эта команда обновляет серверные файлы PZ и заодно синхронизирует Workshop-контент. Используй, если сервер развёрнут через SteamCMD.

Проверка версии мода

После обновления проверь файл mod.info в папке мода - поле modversion покажет актуальную версию:

cat ~/.steam/steam/steamapps/workshop/content/108600/2392018172/mods/RisingDeadExpanded/mod.info | grep modversion

Диагностика: конфликты и краши

Моды - основная причина нестабильности серверов PZ. Вот систематический подход к диагностике.

Где смотреть логи

~/.cache/Zomboid/server-console.txt     # основной лог сервера (Linux)
~/.cache/Zomboid/Logs/                  # папка с детальными логами

На хостинге логи обычно доступны через вкладку Console или Logs в панели управления.

Типичные ошибки и их причины

Ошибка: мод не найден при загрузке

ERROR: Workshop mod not found: RisingDeadExpanded

Причина - Mod ID в параметре Mods написан с ошибкой или с другим регистром. Mod ID чувствителен к регистру: risingdeadexpanded и RisingDeadExpanded - это разные строки.

Ошибка: не удалось скачать мод

ERROR: Failed to download workshop item 2392018172

Причина - сервер не может обратиться к Steam. Возможные причины: нет интернета, Steam CDN недоступен, или SteamCMD не авторизован. На VPS и хостингах обычно решается перезапуском сервера.

Краш с JAVA EXCEPTION

FATAL ERROR: java.lang.NullPointerException at zombie.characters.ZombieClassification

Причина - конфликт модов, меняющих одни и те же игровые классы. Нужно найти виновника методом бисекции.

Метод бисекции для поиска конфликтующего мода

  1. Раздели список Mods пополам
  2. Запусти сервер только с первой половиной
  3. Если краш исчез - виновник во второй половине
  4. Продолжай делить пополам, пока не найдёшь конкретный мод
  5. Проверь страницу мода на Workshop - возможно, автор уже знает о конфликте

Мод требует более новую версию PZ

WARNING: Mod RisingDeadExpanded requires PZ version 41.80+, server runs 41.78

Обнови сервер PZ через SteamCMD или через панель управления хостинга до актуальной версии.

Конфликты из-за порядка загрузки

Некоторые краши происходят только при неправильном порядке модов. Если видишь ошибки типа “required mod not loaded”, проверь зависимости (раздел выше) и переупорядочь Mods.

Удаление и деактивация модов

Деактивировать мод без удаления файлов

Убери Mod ID из параметра Mods, но оставь Workshop ID в WorkshopItems. Мод будет скачан, но не активирован - удобно для временного отключения при диагностике.

Полное удаление мода

  1. Убери Workshop ID из WorkshopItems
  2. Убери все Mod ID этого мода из Mods
  3. Удали папку мода из ~/.steam/steam/steamapps/workshop/content/108600/<WorkshopID>
  4. Перезапусти сервер

Если мод добавлял предметы или строения в мир - они останутся в сохранении как “неизвестные объекты”. Это не ломает игру, но может вызывать предупреждения в логах.

Рекомендуемые практики для стабильного мод-сервера

Ведение списка модов в отдельном файле. Держи рядом с servertest.ini текстовый файл mods-list.txt с колонками: Workshop ID, Mod ID, название мода, версия, дата последней проверки. Это сильно ускоряет диагностику.

# mods-list.txt
# WorkshopID | ModID | Название | Версия | Проверен
2392018172 | RisingDeadExpanded | Rising Dead Expanded | 2.4.1 | 2026-05-10
2200148440 | BritasWeaponPack | Brita's Weapon Pack | 3.1 | 2026-05-10

Тестирование перед продакшн-запуском. Добавляй новые моды на тестовый сервер (или локально) перед установкой на основной. Особенно это важно для модов, меняющих AI зомби или физику предметов.

Резервное копирование сохранения. Перед добавлением или удалением модов копируй папку сохранения:

cp -r ~/.cache/Zomboid/Saves/Multiplayer/servertest ~/backups/servertest-$(date +%Y%m%d)

Не перегружай список модов. Каждые 10 активных модов добавляют ~200-400 МБ к потреблению RAM при загруженном сервере. При 30+ модах рекомендуется 8 ГБ RAM.

Обновляй моды после обновлений самой игры. Патчи PZ часто ломают совместимость модов. После каждого обновления игры проверяй, обновил ли автор мод, иначе возможны краши.

Связанные материалы

Если ты только разворачиваешь сервер PZ с нуля, начни с руководства Как запустить сервер Project Zomboid - там описан весь базовый процесс установки. Для сравнения с другими выживалками почитай 7 Days to Die: настройка сервера - у 7DTD схожая механика модов через файл настроек. Если интересуешь моддингом Terraria, загляни в Terraria сервер: установка и настройка.

Заключение

Установка модов Workshop на сервер Project Zomboid сводится к двум параметрам в servertest.ini: WorkshopItems для скачивания архивов и Mods для активации. Главная ошибка новичков - путаница между Workshop ID (числовой, из URL) и Mod ID (строковый, из mod.info). Разобравшись с этим различием один раз, ты сможешь собирать любые конфигурации модов. При конфликтах всегда начинай с логов и метода бисекции - это быстрее, чем искать ответы вслепую. Регулярное резервное копирование сохранений защитит от потери прогресса при экспериментах с новыми модами.

Pterohost - хостинг серверов Project Zomboid с автоматической установкой через панель, NVMe-хранилищем и круглосуточной технической поддержкой. Настроишь моды в пару кликов без ручного редактирования конфигов. Промокод 4START даёт -20% на первый заказ. Заказать сервер Project Zomboid