god-hand-decomp

What the project is

god-hand-decomp is a C project hosted on GitHub. A work-in-progress matching decompilation of God Hand (PS2, NTSC-U, SLUS-21503). Matching decompilation of God Hand (PS2, 2006, Clover Studio / Capcom). The goal is to rewrite the game's machine code as C/C++ that, compiled with the original toolchain, reproduces the NTSC-U retail master (SLUS-21503) byte-for-byte from a single source tree. The repository is maintained by LucasPicoli and tracks activity through its public issue tracker and commit history. Readers who want a working example rather than a bare library will find the documentation and the linked resources useful for getting a first build running.

What it offers

The god-hand-decomp repository documents several concrete capabilities that shape how people use it. Splat disassembles the retail boot ELF into one monolithic assembly file Every function starts as raw assembly included from C via INCLUDE ASM(...). Objdiff scores each compiled unit against the retail disassembly. A One ratchet drives everything: every commit keeps the full ELF byte-identical Decomp.me . the collaborative matching-scratch model These points are taken from the project README, so they reflect what the maintainers actually ship rather than marketing claims. Checking the file list and the example directories gives a fuller picture of how each piece fits together.

How to set it up

Getting god-hand-decomp running starts with cloning the source from https://github.com/LucasPicoli/god-hand-decomp. The README lists the commands needed to fetch the code and build or launch it. Representative steps from the documentation include: ./scripts/extract_iso.sh ./scripts/setup_toolchain.sh docker run --platform linux/amd64 -v "$PWD":/src -w /src nixos/nix \ python compile.py --setup # build units + write objdiff.json. After the code is on disk, the project instructions walk through configuration and any dependencies. Following the order shown in the README avoids the common setup mistakes that come from mixing steps.

License and project status

god-hand-decomp is written primarily in C and is released under the MIT license, which sets the terms for reuse and redistribution. The project reports around 22 stars on GitHub, a signal of how many developers have bookmarked it. The source was last updated on 2026-08-21. The canonical location is https://github.com/LucasPicoli/god-hand-decomp, where the license file, the changelog and the open issues give the most current state of the work. Anyone planning to depend on it should read the license text directly before shipping it inside another product.

Editorial conclusion

The god-hand-decomp source lives at https://github.com/LucasPicoli/god-hand-decomp under the MIT license and is mainly written in C. The README and the linked examples remain the place to confirm the current behaviour before adopting the project.