Gillou68310/DukeNukemZeroHour: A decompilation of Duke Nukem Zero Hour

A decompilation of Duke Nukem Zero Hour for N64.

Note: To use this repository, you must already own a copy of the game.

The build instructions assume that you will be using Ubuntu 20.04; either natively or via WSL2.

Package requirements can be install via:

sudo apt update
sudo apt install make git build-essential binutils-mips-linux-gnu cpp-mips-linux-gnu python3 python3-pip

Tools requires Python 3.8+. Package requirements can be installed via:

pip3 install --upgrade pip
pip3 install -U splat64[mips]
pip3 install -r requirements.txt

Clone the repository; note the –recursive flag to fetch submodules at the same time:

git clone https://github.com/Gillou68310/DukeNukemZeroHour.git --recursive

Navigate into the freshly cloned repo

Place the Duke Nukem Zero Hour US ROM in the root of this repository, name it baserom.us.z64, and then run the first make command to extract the ROM:

Now build the ROM:

If you did everything correctly, you’ll be greeted with the following:

Creating z64: build/us/dukenukemzerohour.z64
OK

This repository has support for the French versions of the game too.

To build this version, place your ROM in the root of the repo and rename it to baserom.fr.z64. Pass VERSION=fr to the above make commands.

Functions can be decompiled to a state where they are functionally equivalent, but are not a byte-perfect match.
In order to build/test the non-matching, add NON_MATCHING=1 argument to the make commands.

A Docker image containing all dependencies can be built and ran as follows:

docker build --no-cache . -t dukenukemzerohour
docker run --rm -ti --mount src=$(pwd),target=/dukenukemzerohour,type=bind dukenukemzerohour

Then continue with the building instructions

When binding windows or mac folder I strongly recommand installing Mutagen Extension for Docker Desktop.

docker --context=desktop-linux-mutagen run --rm -ti --mount src=$(pwd),target=/dukenukemzerohour,type=bind dukenukemzerohour

Game can be debugged with gdb through mupen64plus (Windows only for now).
In order to have source code information the game should be compiled with modern gcc by adding MODERN=1 to the make command.

Run the gdb server in cmd:

tools\debugger\win32\gdbserver.bat

Then run the gdb client in cmd:

tools\debugger\win32\gdbclient.bat

It’s also possible to debug within vscode with the Native Debug extension.

Run the gdb server in cmd:

tools\debugger\win32\gdbserver.bat

Then run the “GDB Client(Win32)” configuration in vscode.

• asm-differ; rapidly diff between source/target assembly
• decomp-permuter; tweaks code, rebuilds, scores; helpful for weird regalloc issues
• mips2c; assembly to C code translator
• splat; successor to n64split