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/, along with the dependencies and game jar.

Other

1. Install Java 17 or above.
2. Download the latest .zip from Releases.
3. Extract the zip.
4. Open your command line to the bin folder and execute ZomboidDecompiler "PATH", replacing PATH with the path to your game installation's ProjectZomboid folder.
   • Example: ZomboidDecompiler "D:\Program Files (x86)\Steam\steamapps\common\ProjectZomboid"
5. Wait a few minutes for decompilation to complete. The decompiled source code will be written to output/, along with the dependencies and game jar.

Features

• Single click game decompilation.
• Automatic gathering of game dependencies as decompilation context and for future recompilation.
• Renaming of function parameters using Rosetta data.
• Renaming of other variables according to type to enhance readability.

Command Line Interface

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

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 included, but when building you must provide these yourself.