Моды на сервер Project Zomboid в Build 42: WorkshopItems, Mods и почему мод не грузится

После перехода серверов на Build 42 чаще всего жалуются на одно: «моды скачались, а в игре их нет». Сервер при этом стартует без единой ошибки, и за что хвататься, непонятно.

Обычно дело в двух строках servertest.ini. Они отвечают за разное, и в 42-й сборке одну из них пишут не так, как в 41-й.

Установка самого сервера, память и порты описаны в отдельной статье. Дальше считаем, что без модов сервер у тебя уже запускается.

Две строки, две задачи

Моды настраиваются в %USERPROFILE%\Zomboid\Server\servertest.ini.

WorkshopItems= говорит серверу, что скачать. Это числовые номера из Steam Workshop через точку с запятой.

Mods= говорит, что загрузить и в каком порядке. Здесь уже внутренние имена модов, тоже через точку с запятой.

Номера и имена разные, отсюда вся путаница. Если мод есть в WorkshopItems, а в Mods его нет, он спокойно скачается и так и останется лежать на диске. В логе об этом может не быть ни слова.

Где взять Workshop ID

Открой страницу мода в Steam Workshop. В адресе есть параметр id= с длинным числом, его и бери. У коллекции тоже есть такой номер, но в WorkshopItems он не подходит: туда пишут номера каждого мода из неё.

WorkshopItems=1234567890;9876543210

Где взять Mod ID

Mod ID записан внутри скачанного мода, в файле mod.info, строка id=. После первой загрузки моды лежат примерно здесь:

steamapps\workshop\content\108600\<Workshop ID>\mods\<папка мода>\

У модов под B42 внутри есть подпапки common и папки версии вроде 42. mod.info для 42-й сборки ищи в папке версии.

Тут легко ошибиться. В одном предмете Workshop бывает сразу несколько модов: несколько папок в mods, у каждой свой id=. А название на странице Workshop часто не имеет ничего общего с id=. В Mods= пишут то, что стоит в mod.info.

Новый формат Mods= в Build 42

В 42-й сборке перед каждым Mod ID ставится обратный слэш:

Mods=\ModOptions;\P4HasBeenRead;\JeevesClaims

Строка без слэшей, оставшаяся от 41-й сборки, на B42 не загрузит ни одного мода, и сервер об этом промолчит. Переносишь конфиг со старого сервера — начни проверку отсюда.

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

Моды в Mods= загружаются в том порядке, в котором записаны. Если мод требует другой мод, зависимость должна стоять раньше. Что именно нужно моду, видно в его mod.info (поле require) и обычно на странице Workshop в блоке «Требуемые предметы».

Зависимость, которую не вписали в WorkshopItems, не скачается, а без записи в Mods не загрузится. Так что смотреть приходится обе строки.

Моды-карты и строка Map=

Карту прописывают в трёх местах: Workshop ID в WorkshopItems, Mod ID в Mods и имя папки карты в Map=. Имя папки берётся из media\maps внутри мода. Пользовательские карты пишутся перед ванильной:

Map=MyCustomTown;Muldraugh, KY

Если забыть про Map=, мод загрузится, а новых мест на карте не будет.

Добавлять моды в уже живой мир

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

Перед любой правкой списка модов сделай копию папки %USERPROFILE%\Zomboid\Saves\Multiplayer\servertest. У сервера есть свои бэкапы, но ручная копия перед экспериментом спокойнее.

Симптомы и причины

Что видишь	Скорее всего
Мод скачался, в игре его нет	нет в Mods= или записан без \
Сервер стартует, но часть модов молчит	в Mods= вписано название страницы, а не id=
Ошибки про отсутствующие файлы Lua или текстуры	не хватает зависимости или нарушен порядок
Игроков кикает при входе	у клиента другая версия мода, и срабатывает DoLuaChecksum
Мод работает в одиночной игре, но не на сервере	мод только под 41-ю сборку или клиентский
Карта в списке модов есть, а в мире её нет	не прописана в Map=

Если внутри мода только папка media, без common и 42, его делали под B41. На стабильной 42-й сборке на такой мод лучше не рассчитывать, даже если сервер его «загрузил».

Игрокам подписываться на моды не нужно, при подключении игра сама скачает то, что стоит на сервере. Если после обновления мода игроков начало выкидывать, перезапусти сервер, чтобы он подтянул ту же версию, что уже у клиентов.

Как поручить сборку списка агенту

Чтобы собрать Mods= на двадцать модов руками, надо открыть двадцать папок, в каждой найти mod.info, выписать id= и нигде не ошибиться со слэшами и порядком. Скучно, а одна пропущенная буква потом съедает вечер.

Дока — ИИ-агент для компьютера, который сам ходит по папкам и правит файлы. Покажи ей папку сервера и папку Zomboid и попроси:

• «Пройди по всем модам в workshop\content\108600, собери их id= и составь строку Mods= для Build 42 с учётом зависимостей из require»;
• «Сверь WorkshopItems и Mods: что скачано, но не подключено, и наоборот»;
• «Найди моды, у которых нет папки 42, — они, похоже, только под B41»;
• «Сделай копию сохранения, потом добавь в конфиг вот эти три мода».

Агент смотрит в сами файлы на диске, пересказывать ему ничего не нужно. Попроси показать новую строку Mods= до записи в servertest.ini, так ошибку видно сразу. А если после перезапуска мод всё равно не встал, пусть прочитает лог сервера и найдёт строку с причиной.

Модель можно держать локальной, тогда список модов и конфиги останутся на компьютере. Если он и так нагружен сервером и игрой, подключи на время облачную модель.

С чего начать

Возьми один мод без зависимостей. Впиши его в обе строки, перезапусти сервер и зайди проверить. Заработал — добавляй следующий.

Если список уже длинный и что-то из него молчит, скачай Доку и попроси сверить обе строки с тем, что лежит в папке Workshop. Про моды на других серверах у нас тоже есть: DayZ и Minecraft Forge.