xD3I/PZ_Optimization
GamesJava class overrides and a benchmarking harness that reduce stutter and speed up chunk loading in Project Zomboid Build 42.
What it does
PZ_Optimization targets performance in Project Zomboid Build 42.22.2: smoother frames, faster chunk loading, a quicker boot and load, and optional visual enhancements. It works by shipping edited game classes rather than replacing projectzomboid.jar; since 42.22.1 the jar is signed, so the overrides load through a Java agent started by one launcher argument. The classes only load for the game revision they were built against — on any other revision they log one line and the game runs stock (how it works).
The repository also contains the benchmark harness and run log used to produce the numbers in the README, with before/after comparisons across driving, thunderstorm, horde and boot scenes on desktop, MacBook, handheld and low-end laptop hardware (benchmarks).
Quick start
Requirements: Project Zomboid Build 42.22.2 from Steam, on Windows, Linux or macOS. Subscribing alone is not enough; the installer is a one-time step.
- Subscribe to PZ_Optimization on the Steam Workshop and let Steam download it.
- In the game's main menu, open Mods and enable PZ_Optimization; a window shows your install command.
- Copy that command and run it in PowerShell (Windows) or a terminal (Linux, macOS). To get the command without the in-game window, use
irm https://github.com/xD3I/PZ_Optimization/releases/latest/download/install.ps1 | iexon Windows orcurl -fsSL https://github.com/xD3I/PZ_Optimization/releases/latest/download/install.sh | bashelsewhere. - Quit the game; the installer copies the files once the game has closed.
- Start the game again and disable the mod. A new PZ OPTIMIZATION item appears in the main menu.
On Windows and macOS with Build 42.22+, one further step is mandatory: the installer prints a Steam launch option line that must go into Project Zomboid's Properties > General > Launch Options, keeping any existing options after %command%. Without it the game closes immediately (Windows) or runs stock (macOS) (Windows launch option).
A manual install is also documented, copying pzopt-classes into the game folder and adding the -javaagent entry to ProjectZomboid64.json (install guide, Method C). After a game update, run the install command again for a matching release; the built-in updater in the PZ OPTIMIZATION menu offers one-click updates.
Constraints
- Other mods and multiplayer are untested and unsupported; installing is client-side and joining a server may or may not work.
- The overrides refuse to run on any revision other than the one they were built for, so a game patch temporarily returns you to stock behavior until a matching release is installed.
- Since Build 42.22 the jar is signed, requiring the Java agent and, on Windows/macOS, the Steam launch option; uninstalling must remove both the files and that option line, otherwise the game will not start.
- The project declares no license, and the edited class sources under
src/overrides/are derived from the game's shipped jar.
HotRepo's take
The README is unusually measurement-heavy for a game performance mod: it publishes per-scene runs on a linked dashboard, compares against nine other Workshop performance mods, and includes a run log going back to 2026-09-24 (every run). The repository also contains the harness that produces those runs, which is more than most performance mods offer. Its only HotRepo listing so far is 6th on the Java weekly chart for the week of 2026-11-17, with 43 stars gained; the 230 stars total are modest, so treat the README benchmarks as the author's own measurements on the listed hardware rather than an independent performance review.
Written by AI from the project's README, updated . The project's own docs are the source of truth.
You might also like
- zed-0xff/ZombieBuddyJava agent framework for Project Zomboid modders to patch game classes at runtime and expose Java APIs to Lua.
- oceanpacificpeace/lichii-shader-syncDownloads shared Vulkan shader caches into Lichii/Eden emulators to reduce first-play stutter.
- Badgenyamultiplexer/pc-game-fps-doctorA Windows tool for diagnosing game startup errors, stutters and lag, then fixing settings with one-click undo.
- MCRcortex/voxyA Minecraft mod that renders distant chunks at lower detail, so large worlds load and display without harsh draw-distance cutoffs.
- GaelQuinta/minecraft-metal-shadersNative Metal shaders that give Minecraft Java on Apple Silicon Macs shadows, clouds, water reflections and HDR at Retina resolution.