Zomboid Decompiler

Simplified decompilation tool for Project Zomboid powered by Vineflower.

Usage

Windows

1. Install Java 17 or above.
2. Download the latest .zip from Releases.
3. Extract the zip.
4. Navigate to bin/ and run ZomboidDecompiler.bat.
5. Wait a few minutes for decompilation to complete. The black box will close when the program has finished.
   • If you receive an error about not being able to find the game directory, open your command line to the bin folder and execute ZomboidDecompiler.bat "PATH", replacing PATH with the path to your game installation's ProjectZomboid folder.
     • Example: ZomboidDecompiler.bat "D:\Program Files (x86)\Steam\steamapps\common\ProjectZomboid"

The decompiled source code will be written to output/.

Other

1. Install Java 17 or above.
2. Download the latest .zip from Releases.
3. Extract the zip.
4. Navigate to bin/ and run ZomboidDecompiler.
   • If you receive an error about not being able to find the game directory, open your terminal and run ZomboidDecompiler PATH replacing PATH with the path to your game installation's ProjectZomboid folder.
     • Example: ZomboidDecompiler "~/.steam/steam/steamapps/common/ProjectZomboid"
5. Wait a few minutes for decompilation to complete. The decompiled source code will be written to output/.

Features

• Single click game decompilation.
• Addition of doc comments, either scraped from the official Javadocs or community written.
• Line number remapping for remote debugging.

Version compatibility chart

Sometimes the game changes too much for Zomboid Decompiler to reasonably maintain compatibility with older versions. Downloads for the latest version supporting certain game versions are listed here.

Game version	Last supporting version
42.13.0–latest	latest
unknown–42.12.3	v0.2.3

Command Line Interface

Launch with -h or --help for information about command line parameters.

Remote debugging

A basic guide on using ZomboidDecompiler for remote debugging is hosted here.

Building

ZomboidDecompiler can be built with gradlew build.
You can include Rosetta files in src/main/resources/rosetta/ to be used as defaults when no rosetta directory is passed. The standard binaries in Releases are built with the latest Rosetta data included.