Установка WorkshopBridge для Project Zomboid без Steam

Как установить WorkshopBridge для Project Zomboid без Steam, настроить steamcmd и устранить типичные проблемы Windows и NixOS.

В этом документе «папка Zomboid» — каталог сохранений и кэша игры: ~/Zomboid в Linux и %USERPROFILE%\Zomboid в Windows. Там находятся сохранения, моды и журналы. Это не папка установки игры, где находится ProjectZomboid.jar.

Установите ZombieBuddy один раз; исходная инструкция ведёт на страницу проекта GitHub (открывается в новой вкладке).

Выпуски WorkshopBridge (открывается в новой вкладке)

Скопируйте каталог WorkshopBridge из релиза в папку mods внутри папки Zomboid и включите мод через меню Mods, как любой другой мод.

Настройка steamcmd

Выберите один из двух вариантов:

Поручить установку моду: при первом обновлении WorkshopBridge автоматически загружает официальный steamcmd от Valve в Zomboid/workshop_cache/steamcmd/.
Использовать собственную копию: создайте Zomboid/workshopbridge.properties в папке Zomboid и добавьте строку:

steamcmd.path=C:/path/to/steamcmd.exe

В Windows допустимы прямые косые черты; они также позволяют избежать экранирования обратных слешей в Java properties, где одинарная последовательность \t превращается в табуляцию. Если всё же используете обратные слеши, удваивайте каждый из них:

C:\\path\\to\\steamcmd.exe

Мод проверяет путь, запуская <exe> +quit. Если путь неверен, проверка быстро завершается ошибкой и предлагает исправить или удалить его. Если путь не задан, мод использует управляемую копию и сначала автоматически загружает её при необходимости.

Дополнительные сведения об ограничении длины пути доступны в документации Microsoft (открывается в новой вкладке).

Для NixOS: steamcmd от Valve нельзя запустить напрямую, поскольку отсутствует /lib/ld-linux.so.2. Установите steam-run из nixpkgs (или включите nix-ld); если steam-run доступен, WorkshopBridge автоматически запускает steamcmd через него.

Запуск игры

Запустите игру. Для запуска без Steam (GOG) используйте флаг -Dzomboid.steam=0. По документации WorkshopBridge не использует Steamworks.

Если сама игра запущена внутри песочницы bubblewrap через steam-run (часто на NixOS), добавьте -Djdk.lang.Process.launchMechanism=FORK в командную строку Java игры. Стандартный механизм запуска процессов JDK posix_spawn блокируется песочницей, поэтому без этого флага steamcmd не стартует.

Примечания для Windows

Папка Zomboid находится в %USERPROFILE%\Zomboid: нажмите Win+R, вставьте %USERPROFILE% и откройте каталог Zomboid. Моды помещаются в Zomboid\mods; workshopbridge.properties, если используется, кладётся непосредственно в Zomboid.
Windows Defender / SmartScreen может поместить в карантин или заблокировать только что загруженный steamcmd.exe. Если загрузки перестали работать сразу после автоматической подготовки, проверьте журнал защиты Defender и восстановите/разрешите файл либо добавьте в разрешённые папку Zomboid\workshop_cache\steamcmd. У загруженного exe также может быть отметка блокировки: правой кнопкой по steamcmd.exe → Properties → отметьте Unblock → OK, затем повторите попытку.
При редактировании workshopbridge.properties в Notepad выберите File → Save As и установите тип Save as type в All files; иначе файл станет workshopbridge.properties.txt, который мод игнорирует. Подходит обычная кодировка UTF-8.
Если установка не проходит, а мод находится во вложенной папке с очень длинным путём, причиной может быть ограничение Windows в 260 символов. Сообщение об ошибке укажет на это, если такая причина вероятна. Инструкция предлагает включить длинные пути через HKLM\SYSTEM\CurrentControlSet\Control\FileSystem\LongPathsEnabled.

Устранение неполадок

Если steamcmd завершается сообщением posix_spawn failed, error: 13 (Permission denied), стандартный механизм процессов JDK posix_spawn может быть заблокирован. Добавьте -Djdk.lang.Process.launchMechanism=FORK в командную строку Java игры вручную.

Если steamcmd не может запускаться с игрового диска (например, это съёмный том noexec или подключённая в песочнице папка), мод автоматически загружает исполняемый файл steamcmd в ~/.cache/workshopbridge/steamcmd (или $XDG_CACHE_HOME; в Windows — %LOCALAPPDATA%\workshopbridge\steamcmd) и повторяет попытку. Загружаемые из Workshop материалы при этом остаются в Zomboid/workshop_cache на игровом диске.