Мод «PZ_Optimization - FPS Boost & Performance Fix: Less Stutter, Less Lag, Faster Chunk Loading [B42] (m» для Project Zomboid

Мод повышает производительность Project Zomboid Build 42 за счёт подмены классов игры. Это не Lua-мод: подписка в Workshop только скачивает файлы, а устанавливать их нужно вручную или через входящий в комплект скрипт. Включение в списке модов ничего не даёт.

Мод сокращает задержки при потоковой загрузке чанков и стабилизирует время кадра. Добавляет вкладку настроек (Options > Optimizations) и внутриигровой оверлей времени кадра (F9). Работает в одиночной и многопользовательской игре, только на стороне клиента. Steam-версия на Windows, Linux и macOS.

Техническая информация:

• Workshop ID: 3805285544
• ID мода: PZ_Optimization
• Папка мода: PZ_Optimization

Что делает: Project Zomboid загружает и запекает карту чанками. В стандартной игре загрузка, запекание и освещение загруженного экрана попадают в один кадр, что проявляется как подтормаживание при вождении или повороте. Подмены выносят эту работу из игрового потока, распределяют её по кадрам и кэшируют то, что стандартная игра пересчитывает каждый кадр (лужи, дождь, вырезы, свет, звуковые зоны). На 5120x2160 с RTX 4090: p99 времени кадра при вождении 19 → 8 мс, без ограничения ~270 → ~500 fps, в грозу 83 → 188 fps.

Запуск и загрузка: от запуска до главного меню и от «Продолжить» до готовности мира на одном сохранении – стандарт 7.55 с + 7.67 с, с модом 4.88 с + 3.47 с.

Как это работает: лаунчер (ProjectZomboid64.json) ищет файлы в папке игры раньше, чем в projectzomboid.jar, поэтому отдельный .class-файл с тем же именем заменяет класс из jar. В моде 422 файла (76 подменённых классов игры, пакет pzopt, Lua, превью-ролики, манифест) в папке pzopt-classes ; сам projectzomboid.jar не изменяется. При запуске проверяются ревизия игры и sha256 каждого подменённого класса; при любом расхождении игра работает как стандартная.

Установка на Windows:

• Подписаться, дождаться загрузки Steam, закрыть игру.
• Открыть PowerShell и выполнить (при другой библиотеке Steam изменить путь): powershell -ExecutionPolicy Bypass -File «C:\Program Files (x86)\Steam\steamapps\workshop\content\108600\3805285544\mods\PZ_Optimization\42\install.ps1»
• Скрипт находит игру через список библиотек Steam, проверяет ревизию, не перезаписывает существующие файлы и записывает скопированное в pzopt-installed.txt.
• Запустить игру из Steam. Первый запуск на несколько секунд дольше.

Удаление: та же команда с -Uninstall. Флаг -Status показывает, что установлено и не изменился ли какой-либо файл.

Установка на Linux и macOS:

• Linux: bash ~/.local/share/Steam/steamapps/workshop/content/108600/3805285544/mods/PZ_Optimization/42/install.bash
• macOS: bash ~/Library/Application\ Support/Steam/steamapps/workshop/content/108600/3805285544/mods/PZ_Optimization/42/install.bash
• Те же флаги: --status, --uninstall, --dir <папка игры>.

Оверлей производительности (F9): по умолчанию выключен. Нужно включить «Sample frame times and utilization» в Options > Optimizations > Performance overlay и перезапустить игру, затем F9 переключает оверлей. Показывает время кадра и его хвост (p99 / p99.9 / max, 1 %-low, джиттер, всплески), занятость GPU, нагрузку игрового и рендер-потока, строку вердикта, дерево игрового потока и граф пламени, график кадров. Работает одинаково на всех платформах, без MangoHud и RivaTuner.

Настройки: Options > Optimizations (сохраняются в Zomboid/pzopt/options.ini, применяются при следующем запуске) содержат все ключи с чекбоксами, ролики сравнения «стандарт против оптимизированного» и шкалы эффекта для настройки под курсором, а также кнопки «Disable all (stock game)» и «Enable all». В Options > Display добавляется пункт «Uncapped» для частоты кадров и отдельная частота кадров меню.

Обновления: после первой установки пункт в главном меню обновляет файлы (один запрос к GitHub за запуск; отключается в Options > Optimizations > Updates). Файлы собраны под одну ревизию игры: после обновления игры она работает как стандартная, пока не выйдет сборка под новую ревизию.

Апскейлер: при включении мир рендерится в долях экрана (Quality 67 %, Performance 50 % по каждой оси) и масштабируется обратно до UI, текста, курсора и экранного шейдера, которые остаются в полном разрешении. FSR 1.0 (любая GPU) восстанавливает края и повышает резкость примерно за 0.1 мс; DLSS (RTX; требуется собрать shim, см. README) также накапливает детали между кадрами.

Включение: Options > Optimizations > Upscaling > Upscaler = fsr1, выбрать качество, перезапустить игру (в console.txt появится "[pzopt] upscaler: fsr1 at 50 %"). Помогает, когда ограничение в GPU (вердикт F9 «GPU bound»: 4K / 5K, ноутбуки, встроенные GPU, туман, штормы), а не при «game thread bound» или «at the cap». На 4K лучше FSR 1.0 или DLSS preset F.

Сравнение с другими модами на производительность: на тех же трёх маршрутах (езда 120 км/ч, езда в грозу, круг по Роузвуду) без ограничения кадров, по одному моду за раз. Все они показывают результаты в пределах погрешности от стандартной игры: Project Zomboid Optimiser (Lua-переключатели отладки, копии шейдеров), Tempo (финализация чанков, а не ожидание очереди, которое и даёт хвост), Multi-Cpu Enhance (JSON лаунчера с ParallelGC: паузы по 300 мс, хуже стандарта), Every Texture Optimized (VRAM, а не время кадра), Lugli и Zed's Better FPS (патчи ZombieBuddy отключают покадровую отрисовку чанков, деревьев и полупрозрачных элементов). Этот мод: 481 / 246 / 456 fps, p99 8.8 / 13.8 / 8.5 мс.