A matching decompilation of Ratchet: Deadlocked (2005) for PlayStation 2.
The main program, front end and 47 levels, rebuilt as C matching retail byte for byte.
Warning
This repository has no game data, executables, disc images or proprietary toolchains. You need your own copy of the game. Read LEGAL.md before contributing.
Progress is tracked on ByteMatch, one badge per version below.
Badges by part of the game and by level are in docs/build/progress.md, and
python3 tools/progress.py prints the counts.
| Release | Region | Boot executable | Code | Notes |
|---|---|---|---|---|
| v1.00 | NTSC-U | SCUS_974.65 |
 |
Primary version |
| v1.00 | PAL | SCES_532.85 |
 |
Released as Ratchet: Gladiator |
The same C counts on both discs wherever it builds to their bytes. Expected SHA-1 of the primary executable:
aa91b1c3b9b1a244320c47580b77342ef9856e95
Both discs' programs and how they are counted: docs/build/levels.md.
On Linux and macOS the build runs in a container, so you need Docker or Podman, and Python 3.10+.
git clone https://github.com/OpenRAC/rac4-decomp.git && cd rac4-decomp
cp /path/to/SCUS_974.65 baserom/SCUS_974.65 # from your own disc
bash tools/setup_asm.sh
git clone https://github.com/AngheloAlf/SN-Systems-ProDG_for_PS2_3.01 toolchain/sn-prodg-3.01
git clone https://github.com/AngheloAlf/sce_ps2_sdk_24 toolchain/sn-prodg-24
bash tools/docker/run.sh bash tools/build.shWindows, both discs' levels and every step in detail: docs/build/building.md.
Start with CONTRIBUTING.md and AGENTS.md. All docs are listed in docs/README.md:
- docs/build/ - building, the toolchain, levels, overlays and the packed executable
- docs/contributing/ - matching workflow, near misses, PAL signatures and the permuter
- docs/agents/ - instructions for AI agents
- docs/history/ - notes from earlier matching sessions
Keep the build matching retail. Never commit game images, extracted game data or proprietary compiler binaries.
- rac1-decomp - layout, progress workflow, toolchain notes, the libgcc recipe and SN assembler tools.
- rac3-uya-decomp-pal - levels from the disc, the function inventory, the catalogue and the report.
- rac3-uya-decomp by vetusmagnus - compiler research for the closest engine relative.
- OpenRAC - sourcing policy and the sibling decompilations.
- Lombyte - checked for coverage of this game (none).
- Wrench by chaoticgd - modding tools, the packed image and the level overlays.
- GCC and newlib - the library sources in
src/libgcc/andsrc/libm/. - splat, spimdisasm, m2c, asm-differ, objdiff, ByteMatch and AngheloAlf's PS2 toolchain mirrors.
Code written for this project is under the GNU General Public License v3.0. Code reconstructed from third-party binaries belongs to its copyright holders; see THIRD_PARTY_NOTICES.md.