Моды на Project Zomboid 42 билд: установка на сервер и совместимость
Как ставить моды из Steam Workshop на сервер Project Zomboid Build 42: параметры WorkshopItems и Mods в servertest.ini, проверка совместимости, типовые ошибки загрузки и логи.
Моддинг остаётся одной из главных причин держать сервер Project Zomboid, но с переходом на Build 42 старая привычная папка модов у многих серверов внезапно оказалась почти пустой: часть авторов ещё не портировала свои работы под новую ветку, а сам процесс подключения модов через servertest.ini требует того же внимания к деталям, что и раньше, только на фоне переписанного игрового кода. В этой статье - что изменилось в моддинге между Build 41 и Build 42, как правильно прописать моды в конфиге сервера и как быстро найти причину, если мод не грузится.
Что изменилось в моддинге между Build 41 и Build 42
Build 42 - не косметическое обновление, а переработка значительной части внутреннего кода игры, и моды это затрагивает напрямую:
- Крафт и ремёсла переписаны. Система рецептов в Build 42 работает иначе, чем в Build 41, поэтому моды, добавляющие новые предметы и рецепты, требуют портирования, а не просто копирования файлов.
- Новая система освещения. Моды, завязанные на визуальные эффекты и модели освещения, могут работать некорректно или не работать вовсе без обновления.
- Server-authoritative сеть. Передача предметов между инвентарями, работа с контейнерами и распределение лута теперь считаются на сервере, а не на клиенте. Моды, которые раньше меняли клиентскую логику инвентаря, нужно проверять на актуальность под новую архитектуру.
- Расширенная карта и подвалы. Модам-картам старого формата Build 41 требуется полноценный порт под новую структуру мира, простого переноса файлов недостаточно.
Из-за этого на августу 2026 заметная часть популярных модов Build 41 либо ещё не портирована, либо работает с ограничениями. Перед установкой мода на боевой сервер всегда проверяйте страницу в Steam Workshop: авторы, которые уже завершили порт, как правило, прямо пишут «Build 42 compatible» в описании или в отдельном changelog.
Если вы ещё не переходили на Build 42 именно из-за незавершённой поддержки нужных модов - имеет смысл сначала прочитать про переход с Build 41 на Build 42 и про официальную ветку legacy41, которая позволяет остаться на старой версии столько, сколько нужно.
Как устроена настройка модов в servertest.ini
Как и в Build 41, за подключение модов на сервере Build 42 отвечают две строки конфигурационного файла servertest.ini, но роль каждой стоит понимать точно:
| Параметр | Что содержит | Формат |
|---|---|---|
WorkshopItems= | Числовые ID подписок Steam Workshop - что скачивать | Список чисел через ; |
Mods= | Внутренние ID модов - что реально подключать после загрузки | Список строковых ID через ; |
WorkshopItems= говорит серверу, что забрать из Steam Workshop, а Mods= - что из скачанного реально включить. Это разные идентификаторы: Workshop ID - число из URL страницы мода, Mod ID - внутреннее имя, которое указано в описании самого мода (обычно в разделе «Mod ID» или «How to install»).
Где найти оба идентификатора
- Откройте страницу мода в Steam Workshop.
- В адресной строке найдите число после
?id=- это Workshop ID. - В описании мода найдите строку вида
Mod ID: SomeModName- это внутренний Mod ID, который пойдёт вMods=.
Пример конфигурации
WorkshopItems=2685168362;2900665603;2169435993
Mods=Common Sense;Brita;ModOptionsПорядок в обеих строках должен совпадать позиционно. Если Common Sense стоит первым в Mods=, то соответствующий ему Workshop ID тоже должен стоять первым в WorkshopItems=. Разделитель - точка с запятой без пробелов вокруг неё.
Порядок загрузки и зависимости между модами
Некоторые моды требуют другие моды в качестве зависимостей - библиотеки функций, framework для UI, общие ресурсы. Такие зависимости нужно указывать раньше зависимого от них мода в обеих строках:
; ModOptions - зависимость, ставим первым
Mods=ModOptions;Brita
WorkshopItems=2169435993;2900665603Если зависимость окажется после мода, который её использует, сервер может либо не подключить сам мод, либо выдать ошибку в логе о ненайденном классе или ресурсе. Всегда сверяйтесь со страницей мода в Workshop - авторы, как правило, явно перечисляют требуемые зависимости и рекомендуемый порядок в описании.
Pterohost - хостинг Project Zomboid с панелью для управления Workshop-модами без ручного редактирования конфигов через SSH. Промокод 4START даёт -20% на первый заказ. Заказать сервер Project Zomboid
Проверка совместимости мода с Build 42
Перед добавлением мода на живой сервер стоит пройти короткий чеклист:
- Дата последнего обновления мода. Если последнее обновление датировано до 29 июля 2026 (релиз стабильного Build 42) и в описании нет явного упоминания Build 42 - высокий риск несовместимости.
- Комментарии и вкладка обсуждений на странице мода. Игроки обычно быстро сообщают, если мод ломает сервер на новой ветке.
- Тестовый запуск на отдельном экземпляре сервера, а не на боевом мире с игроками - особенно для крупных оверхолов и модов-карт.
- Проверка версии игры у самого мода. Некоторые авторы держат две версии одного мода - для Build 41 и для Build 42 - как отдельные записи в Workshop, важно подписаться на правильную.
Флаг -modfolders и локальные моды
Помимо модов из Steam Workshop, сервер может грузить моды из локальной папки, минуя подписку в Steam - это удобно для собственных модификаций или заранее скачанных архивов. За это отвечает параметр запуска -modfolders с указанием пути к папке:
./start-server.sh -modfolders "/home/pzserver/CustomMods"Сервер ищет моды в трёх местах: подписки Steam Workshop, папка мода внутри директории установки игры и указанная через -modfolders пользовательская папка. Для большинства серверов проще и надёжнее использовать WorkshopItems=/Mods= в конфиге - -modfolders пригождается в основном при разработке собственного мода или при переносе набора модов без повторной загрузки каждого через Steam.
Обновление модов на сервере
Моды из WorkshopItems= сервер обновляет автоматически при каждом запуске - актуальная версия подписки скачивается заново перед стартом мира. Из этого следует практическое правило: обновление сервера означает потенциальное обновление всех подключённых модов одновременно, и если автор мода выпустил breaking change, сервер может перестать запускаться сразу после планового рестарта.
Чтобы снизить риск:
- держите список модов в отдельном файле или заметке отдельно от
servertest.ini, чтобы быстро откатить конкретный Workshop ID при проблеме; - перед плановым обновлением сервера проверяйте changelog каждого крупного мода;
- используйте автоматическое резервное копирование перед любым обновлением конфигурации модов, чтобы можно было быстро вернуть рабочую версию
servertest.ini.
Типовые ошибки и их причины
| Симптом | Вероятная причина |
|---|---|
| Мод не появляется в игре после установки | Не совпадает порядок ID в WorkshopItems= и Mods=, либо неверно указан Mod ID |
| Сервер зависает при загрузке модов | Мод не портирован под Build 42 или конфликтует с другим модом по ID предметов |
| ”Connection lost” сразу после входа игрока | Рассинхрон версий модов между клиентом и сервером |
| Ошибка “Missing dependency” в логе | Не подключена мод-зависимость, указанная в описании основного мода |
| Мод работает нестабильно только у части игроков | У игроков разные версии мода из-за кэша Steam Workshop, нужно принудительно обновить подписку |
Рассинхрон клиент-сервер - самая частая жалоба после обновления модов. У всех участников должен быть строго одинаковый набор Workshop ID и одинаковые версии этих модов. Если игрок не переподключался к Steam Workshop давно, у него может стоять устаревший кэш мода - попросите вручную отписаться и подписаться заново либо перезапустить Steam.
Конфликт ID предметов между разными модами (item ID collision) исторически был проблемой ещё в Build 41 и остаётся актуальным в Build 42: два разных мода могут случайно использовать один и тот же внутренний идентификатор предмета. Решение - отключить один из конфликтующих модов или дождаться патча от автора, который меняет префикс ID.
Где смотреть логи
Логи сервера с построчной загрузкой каждого мода находятся в:
- Linux:
~/Zomboid/Logs/ - Windows:
C:\Users\ИМЯ_ПОЛЬЗОВАТЕЛЯ\Zomboid\Logs\
Файлы именуются по дате и времени запуска. При старте сервера с модами в лог пишутся строки вида:
Loading mod: Brita
Patching: recipe classes...
Patching: item classes...Если загрузка обрывается на конкретном моде без перехода к следующему - именно этот мод и стоит проверять в первую очередь: либо он несовместим с Build 42, либо в конфиге неверно указан его Mod ID. Для доступа к логам через FTP/SFTP на хостинге пригодится статья про подключение по FTP/SFTP.
Pterohost - готовая инфраструктура под моды Project Zomboid Build 42: панель с редактором WorkshopItems, доступ к логам без консоли, DDoS-защита. Промокод 4START даёт -20% на первый заказ. Настроить сервер с модами
Часто задаваемые вопросы
Работают ли моды Build 41 на сервере Project Zomboid Build 42?
Не автоматически. Значительная часть API крафта, освещения и предметов в Build 42 переписана, поэтому мод должен быть явно обновлён автором под новую ветку. Проверяйте страницу мода в Steam Workshop на пометку поддержки Build 42 перед установкой на сервер.
Как добавить мод из Steam Workshop на сервер Project Zomboid Build 42?
Найдите Workshop ID мода в URL страницы (число после ?id=) и добавьте его в строку WorkshopItems= в servertest.ini. Затем найдите внутренний Mod ID на странице мода и добавьте его в строку Mods= в том же порядке. После правки перезапустите сервер.
Почему мод не загружается на сервере Build 42, хотя указан правильно?
Чаще всего причина - мод ещё не портирован под Build 42, перепутан порядок Mod ID в Mods= относительно Workshop ID в WorkshopItems=, либо не подключена мод-зависимость, от которой зависит основной мод. Проверьте лог сервера на строки с ошибкой загрузки конкретного мода.
Что делать при рассинхроне клиента и сервера из-за модов?
У всех игроков и у сервера должен быть установлен строго одинаковый набор модов и их версий. Рассинхрон обычно возникает после обновления мода на сервере без синхронного обновления у клиентов - попросите игроков перезайти в Steam Workshop и обновить подписку вручную.
Где смотреть логи загрузки модов на сервере Project Zomboid?
В папке ~/Zomboid/Logs (Linux) или C:\Users\ИМЯ\Zomboid\Logs (Windows) - файлы с текущей датой в имени содержат построчную загрузку каждого мода при старте сервера, включая ошибки патчинга и конфликты ID.