A work-in-progress, byte-matching decompilation of Ratchet & Clank (2002) for PlayStation 2.
Reconstructing the original game code in readable C.
> [!NOTE]
> Yes, this project is AI-assisted—that’s pretty obvious.
> AI helps get more done, but the direction and decisions remain human.
> A lot of time and care goes into getting things right. Every PR and issue is manually reviewed.
> [!WARNING]
> Lombyte does not include game data, executables, disc images, or proprietary toolchains.
> A legitimately obtained copy of the **USA / NTSC-U** release (`SCUS_971.99`) is required.
Decompilation progress
Supported version
| Game | Platform | Region | Boot executable |
| ---------------------- | ------------- | ------------ | --------------- |
| Ratchet & Clank (2002) | PlayStation 2 | USA / NTSC-U | `SCUS_971.99` |
Expected SHA-256 of the boot executable:
```text
e050581032e4bb3f20341307da5b69b76f1574910519155380ea771e55c3c0c9
```
Only this release is targeted; other releases and the PlayStation 3 remaster are not supported.
Contributing
You can help improve matching C, recovered names, types, and documentation. See [CONTRIBUTING.md](CONTRIBUTING.md) for more...
Quick setup
```sh
git clone https://github.com/lombyte-project/lombyte.git && cd lombyte
./setup.sh --iso /path/to/your-ratchet-and-clank-usa.iso
```
Windows, macOS and other options: [docs/building.md](docs/building.md#quick-setup).
Work-in-progress C is also welcome when it preserves the matching baseline. Do not submit game images, extracted game data, or proprietary compiler binaries.
Credits
- [objdiff](https://github.com/encounter/objdiff) — object-level comparison.
- [splat](https://github.com/ethteck/splat) and [spimdisasm](https://github.com/Decompollaborate/spimdisasm) — executable splitting and disassembly.
- [Himuro](https://github.com/Mikompilation/Himuro) — PS2 decompilation research and reference EE-GCC toolchain work used by Lombyte's matching compiler profiles.
- [bordplate/RC1](https://github.com/bordplate/RC1), [OpenRAC/rac1-decomp](https://github.com/OpenRAC/rac1-decomp) & [re-rac/rerac](https://github.com/re-rac/rerac) — used as a reference for symbols, structs, and function logic (credited inline in the source).
- The PS2 reverse-engineering and decompilation communities for the tools and research that make matching projects possible.
License
Repository code is distributed under the [GNU General Public License v3.0](LICENSE). Code reconstructed from third-party binaries belongs to its copyright holders; see [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md).
The Lombyte emblem in [`assets/`](assets/) is the project's original artwork.
