Rood Reverse

A reverse engineering of Vagrant Story for PlayStation 1, with a goal of enabling interoperability with modern hardware and fixing bugs in the original game.

This project does not contain any of the original files from the game disk, you must own a copy of the game.

Many thanks to the Chrono Cross Decompilation for much of the sound library code.

Heavily inspired by and indebted to the incredible work of the sotn-decomp team and the PS1/PS2 decompilation Discord server.

Grateful to the authors of Data Crystal’s Vagrant Story page for their excellent work and insights.

Thanks also to the following amazing projects (and their dependencies):

• splat
• maspsx
• decomp.me
• Decomp permuter
• Old GCC
• mkpsxiso
• objdiff
• decomp.dev

Status

Core libraries

Main game engine

Effects

Menus

Title and Ending Sequence

(Naive) Quickstart

0. n.b.: You may want to consider parellizing make with something sensible like -j8.
1. Fork the project
2. Install system dependencies and copy disk image (see "Setup" below)
3. Run make to perform an initial split & build
4. Pick a function to decompile, use make decompme to create a scratch on decomp.me
5. Claim and decompile the scratch
6. Copy the decompiled code where it belongs
7. Optionally use make permute if needed
8. Run make remake, and finally make format if the code compiles successfully
9. Open a PR

Setup

The project is mostly self-configuring but requires a minimal amount of setup.

• Make sure the following packages are installed, older versions may also work but this is not tested. This configuration works as-is on Ubuntu 26.04 on WSL; depending on your distro you may need additional packages.

Package	Minimum Version
clang-format	21.1.8
g++	15.2.0
binutils-mipsel-linux-gnu	2.45.90
make	4.4.
python3	3.14.4
python3-venv	3.14.4
unzip	6.00
wget	1.25.0

Take a look at ./Dockerfile for a minimal setup on Ubuntu

• Dump your original disk to disks/SLUS-01040.bin
• Run make to finish installation and perform an initial build

Build targets

• make should be all that is needed most of the time. The first execution will configure the remaining dependencies in the tools directory and extract the files from the disk; from then on it will perform a minimal rebuild.
• make decompme TARGET=path/to/nonmatchings/source.s uploads the target function to a new decomp.me scratch.
• make permute TARGET=path/to/nonmatchings/source.s invokes the permuter for the target assembly file.
• make remake will delete and re-split the targets; this can be necessary if the dependency management has failed to identify everything that needs rebuilding (in which case a bug report is appreciated!), or if the configuration has changed enough to be no longer valid (e.g. orphaned .d files).
• make format formats the source files and symbol addresses for consistency. Please run this before submitting a PR.
• make commit-check is a convenience that runs format followed by remake
• make clean simply deletes the build and nonmatchings directories
• make clean-all will completely reset the project, including dropping any source changes and data files (but not the disk image). Use with caution.