Skip to content

mateusfavarin/crashbash

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

40 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎮 Crash Bash

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

🔧 Setup

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.

💡Strategy

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.

📁 Folder Structure

  • build: here's where your NTSC-U version of Crash Bash is supposed to be in. Rename your game to bash.bin and drop it in there.
  • decomp: reverse engineered code. Each folder inside decomp/ 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 the decomp/ 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

Progress is measured with the amount of functions decompiled/identified divided by the amount of known functions in each executable.

Functions Identified

Functions Decompiled

About

Reverse engineering project of Crash Bash (PSX)

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published