Skip to content
lombyte-projectPublic

Repository files navigation

Lombyte

Lombyte Project, Ratchet and Clank Decompilation

bytematch progress Community Discord Build guide Contributing guide

A work-in-progress, byte-matching decompilation of Ratchet & Clank (2002) for PlayStation 2.
Reconstructing the original game code in readable C.

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

Lombyte 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:

e050581032e4bb3f20341307da5b69b76f1574910519155380ea771e55c3c0c9

Only this release is targeted; other releases and the PlayStation 3 remaster are not supported.

Contributing

Help with matching C, names, types and docs: CONTRIBUTING.md.

Open the Naming Desk

Quick setup

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/build/building.md.

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 — object-level comparison.
  • splat and spimdisasm — executable splitting and disassembly.
  • Himuro — PS2 decompilation research and reference EE-GCC toolchain work used by Lombyte's matching compiler profiles.
  • bordplate/RC1 and OpenRAC/rac1-decomp — reference for function logic.
  • re-rac/rerac — reference for symbols.
  • 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. Code reconstructed from third-party binaries belongs to its copyright holders; see THIRD_PARTY_NOTICES.md.

The Lombyte emblem in assets/ is the project's original artwork.

Contributors

Languages