This repository is an ongoing decompilation project for the PSX game Crash Bash. To discuss about Crash Bash hacking and reverse engineering, join our Discord:
This project is meant to be used as a submodule of the psx modding toolchain. To get started, clone the toolchain repo, follow the instructions in their README, and then go to the directory psx-modding-toolchain/games/
and clone the repo there.
This project will adopt the Ship of Theseus strategy. By taking advantage of PCSX-Redux 8MB memory expansion, we can re-write game functions and load them in memory, while the original game stays intact. Then, we can force the game to call each function we re-wrote, and compare the output of the decompiled function with the original game function.
build
: here's where yourNTSC-U
version of Crash Bash is supposed to be in. Rename your game tobash.bin
and drop it in there.decomp
: reverse engineered code. Each folder insidedecomp/
corresponds to a different binary in game being reverse engineered.include
: general header files that works for every binary. Specific header files will be inside thedecomp/
folder for each specific binary.plugins
: psx-modding-toolchain plugin file, currently does nothing for this project.scripts
: multiple scripts that helps the reverse engineering project.symbols
: linker scripts containing the external symbols from in-game variables and functions.tools
: code for independent programs used to explore the Bash files.
Progress is measured with the amount of functions decompiled/identified divided by the amount of known functions in each executable.