ZombieBuddy: установка, проверка и удаление загрузчика
ZombieBuddy — сторонний Java-agent для модов Project Zomboid, авторский репозиторий zed-0xff/ZombieBuddy и Workshop 3619862853. Подписки недостаточно: требуется отдельная настройка загрузчика. В обзоре различаются framework v2.3.4 и Windows installer v4.4; игра, загрузчик и установщик не запускались.
Выбор версии и подготовка
Обзор от 23 октября 2026 года называет Windows installer v4.4 от 20 октября, тег windows_installer_4.4 и файл ZombieBuddyInstaller_v4.4.exe; ZIP и tar.gz в списке относятся к исходному коду. Framework v2.3.4 — отдельный выпуск от 3 октября с backport исправления #56 для загрузки Java-модов в 42.21. Записывайте установленную и реально загруженную версию отдельно; файл, лежащий в другой папке, не доказывает активную версию.
На дату обзора автор Workshop указывал B41 и B42.12–B42.21, а development README — Build 42+; это не расширяет поддержку зависимого мода автоматически. Закройте игру, сохраните мир и текущие Steam launch options, копии изменяемых JSON/BAT и путь активной папки игры. Проверьте обычный запуск до изменения. Найдите реальную библиотеку Steam, дождитесь загрузки Workshop или используйте авторский пакет и не смешивайте неотслеживаемые копии разных версий.
Windows: установщик
Материал описывает подписку на точный Workshop-объект и выбор EXE из Assets авторского выпуска v4.4. Затем в интерфейсе установщика выберите установку или обновление и соответствующий режим Normal Launch, Alternate Launch либо Both. Проверьте обнаруженную папку и предварительный список изменений; если установщик просит закрыть Steam для изменения параметров, выполните его инструкции. Включите ZombieBuddy в менеджере модов и полностью перезапустите игру, затем проверьте индикатор.
По описанию автора, v4.4 исправляет обнаружение библиотек Steam, но обзор не проверял установщик. Документ настройки на дату обзора всё ещё ссылался на старый installer v4.1: сравните фактический интерфейс и инструкцию конкретной версии. Завершение установщика само по себе не доказывает настройку выбранного способа запуска.
Ручная настройка Windows
По документации автора, ZombieBuddy.jar и zbNative.dll находятся в <Steam library>\steamapps\workshop\content\108600\3619862853\mods\ZombieBuddy\libs\; их помещают в фактическую папку установки игры, открытую через Steam. Пример библиотеки не является обязательным системным диском и не относится к папке сохранений.
| Режим | Параметр по документации |
|---|---|
| Steam Normal Launch | -agentlib:zbNative -- |
| Alternate Launch | Добавить -agentlib:zbNative к существующей строке SET _JAVA_OPTIONS= в ProjectZomboid64.bat; Steam-параметр Normal сам по себе этот путь не настраивает |
Два завершающих дефиса в Steam-параметре обязательны по описанию. Сохраните остальные опции, не добавляйте повторный agent и не заменяйте целиком BAT-файл; если нужная строка не определена, вернитесь к документации установщика.
Native macOS и Linux
| Платформа | Пример каталога игры |
|---|---|
| macOS | ~/Library/Application Support/Steam/steamapps/common/ProjectZomboid/Project Zomboid.app/Contents/Java/ |
| Linux | ~/.steam/steam/steamapps/common/ProjectZomboid/projectzomboid/ |
Для ручной native-установки macOS/Linux скопируйте ZombieBuddy.jar в соответствующий каталог игры из таблицы. Затем используйте параметр Steam -javaagent:ZombieBuddy.jar -- с завершающим разделителем по авторской инструкции. Включите зависимость и полностью перезапустите игру. Steam Deck с Windows-версией через Proton — иной режим; данный обзор его не проверял.
Индикатор и одобрение
При загрузке автор описывает значок и номер ZombieBuddy слева сверху. Сначала проверьте меню с загрузчиком; если игра не доходит до меню, отмените изменения загрузчика и сравните с обычным запуском. Затем в отдельном тесте включите один зависимый мод и проверьте его отдельную функцию; индикатор не доказывает работу этого мода. Сохраните первую ошибку.
При случайном отказе автор предлагает закрыть игру, сохранить mod_approvals.json и изменить только запись нужного мода и хеша: %USERPROFILE%\.zombie_buddy\mod_approvals.json на Windows или ~/.zombie_buddy/mod_approvals.json на native macOS/Linux. Политика deny-new может пропускать неподтверждённые файлы без диалога; сохраняйте осознанные ограничения и не используйте allow-all для устранения ошибок.
Подпись проверяет идентичность ключа и целостность файла, но не подтверждает безопасность или совместимость. Java-моды могут выполнять код с правами вашей учётной записи; проверяйте источник и одобряйте конкретный мод. При несоответствии берите соответствующие JAR и подпись из одного выпуска автора, не смешивая замены. В заявлении The Indie Stone от 21 октября Java loaders и frameworks указаны вне официальной поддержки моддинга.
Диагностика и журнал
| Симптом | Проверка |
|---|---|
| Workshop подписан, индикатора нет | Файлы и внедрение в активный запуск |
| Normal работает, Alternate нет | Проверить BAT / выбранный установщиком режим |
| Loader виден, Java-моды не работают на 42.21 | Сверить v2.3.4 / #56, включение и разрешения |
| Ошибка JAR или native-библиотеки | Имя файла, реальная папка игры и синтаксис ОС |
| Проблема после обновления или проверки файлов | Сравнить файлы и параметры запуска с сохранённой конфигурацией |
| Не работает только один мод | Минимальный тест и инструкция его автора |
Для одного диагностического запуска Windows Normal в описании приведён -agentlib:zbNative=verbosity=1 --, для native macOS/Linux — -javaagent:ZombieBuddy.jar=verbosity=1 --. Он заменяет существующий аргумент, а не добавляет второй loader; затем верните прежнюю настройку. Сохраните первую ошибку, сборку, версию, источник, способ запуска и минимальный набор модов; перед отправкой удалите частные пути и сведения сервера.
Удаление и возврат
Закройте игру и отключите зависимые Java-моды в тесте. При использовании установщика проверьте доступный Uninstall и его изменения. При ручном удалении сначала отмените агент в Steam и восстановите точечные изменения ProjectZomboid64.json или .bat, затем удалите из папки игры ZombieBuddy.jar, возможный ZombieBuddy.jar.new и на Windows zbNative.dll. При необходимости отпишитесь от пакета.
Папку .zombie_buddy с решениями об одобрении и кешем можно сохранить: её удаление не требуется для остановки агента. Проверьте каждый изменённый способ запуска и отдельный базовый мир. Удаление загрузчика не доказывает восстановление сохранения после других модов. Development README упоминает Java 25, версия 2.3.4 — Java 17, а Gradle относится к разработке; это не основание без необходимости заменять встроенную среду игры.
Сравнение проектов и ограничений перед установкой
| Мод или функция | ОС и зависимости | Игра и мультиплеер | Источники и проверка |
|---|---|---|---|
| PZ3D 0.7.2 | Инструкции Windows; Linux — сайт установки автора; поддержка macOS ожидалась. Требуется официальный ZombieBuddy 2.3.4 или новее. | Точный диапазон патчей игры в обзоре не указан. Автор заявляет поддержку мультиплеера; результат одиночного теста и конкретная конфигурация сервера неизвестны. | Страница автора Workshop и сайт установки. Источники проверялись 13 октября 2026; игра не тестировалась. |
| Project Viewpoint alpha-0.1.6, заметки автора от 10 октября | macOS и Intel Arc обозначены неподдерживаемыми; остальные ОС в рассмотренной записи не перечислены. Требуется ZombieBuddy. | Обзор относит мод к Build 42; точная совместимость с патчем и списком модов неизвестна. Автор заявляет мультиплеер при совместимом списке модов сервера; одиночный тест и конкретная пара с сервером неизвестны. | Workshop и журнал изменений автора. Источники проверялись 13 октября 2026; игра не тестировалась. |
| ZombieBuddy, запись сайта: framework 2.3.4 и Windows installer 4.2 | Авторские инструкции охватывают native Windows, macOS и Linux; Steam Deck / Proton не установлены. Это фреймворк Java-модов; зависимые моды имеют свои требования. | Workshop автора перечисляет B41 и B42.12–B42.21; это не означает поддержки B41 для каждого зависимого мода. FAQ автора заявляет работу в мультиплеере; конкретная установка клиента / сервера и сочетания зависимых модов неизвестны. | Workshop и руководство установки автора. Сравнительная запись проверялась 13 октября 2026; игра не тестировалась. Основной обзор установщика позднее обновлён до v4.4 23 октября. |
| Шейдеры — функция Viewpoint alpha-0.1.6 | Применимы ограничения платформ Viewpoint; отдельная поддержка ОС для шейдеров не указана. Нужны Viewpoint и его ZombieBuddy. | Vanilla / Default / Vivid — встроенные варианты; пользовательские Minecraft / Iris шейдеры экспериментальны. Photon и Hysteria — проекты Minecraft, связь их конкретных выпусков с Project Zomboid не проверена; сочетание пакета с сервером не установлено. | Workshop и заметки автора Viewpoint. Сведения проверялись 13 октября 2026; игровой тест не проводился. |
Общая зависимость от ZombieBuddy не доказывает совместную работу Viewpoint и PZ3D. Доступность в клиенте Steam на дату обзора оставалась неопределённой: публичные баннеры и описания авторов расходились; проверяйте выбранный объект в своём клиенте. Обзор не тестировал установщик, сохранения, GPU, шейдеры или серверные сочетания.
Как сверить авторские источники
Источник указывает репозиторий zed-0xff/ZombieBuddy и рекомендует открывать Releases и Assets автора, отличая установщик от архива исходного кода и framework. Если список не виден, повторно откройте страницу выпуска; не переименовывайте архив в EXE. Метаданные обзора приводят SHA-256 installer v4.4: 251114157204e1eddb3ff20170ff689d29354f74ae8eb03f4e116991c883f637; исполняемый файл не скачивался и этот хеш здесь не проверялся.
По пересказу источника, ошибка #56 связана с изменением сигнатуры loadMods с ArrayList на List; отмеченная разработчиками проверка сопоставления и weaving не была загрузкой игры в 42.21. Номер исправления не устанавливает причину каждого сбоя. Версионированные документы и ссылки автора включены в приватную карту ссылок.