A WIP decomp of Jet Set Radio Future (US).
Disclaimer: This project is intended only for educational and research purposes, and is not indended to promote piracy or violation of any copyright laws. This repository does not include original game executables, nor does it include required game assets. You will need to provide these files from your own copy of the game. Buy a copy. Heck, buy two!
There is a Discord server for the project: https://discord.gg/Ct5r8T3B
- Able to patch into existing game
This project can be built with Visual Studio or Clang, on Windows, macOS, and Linux. Project tooling is developed with Python 3, so that will need to be installed, along with dependencies listed in requirements.txt. CMake will also need to be installed.
Build overview:
- First prepare
jsrf-patcheddirectory with disc files and original executable- Retail disc game files
- Original executable JSRF - Jet Set Radio Future (USA) (MD5:
f4e366bfdceee551a09f42219c90d84e) as filebase.xbe
- You can build in a Docker container, or outside of a container with system tools (e.g. Clang, MSVC).
- If not using a container to build, install system deps:
- Ensure Python 3 is installed.
- Install Python requirements:
python -m pip install -r requirements.txt - On Windows you can use Visual Studio (MSVC).
- On Linux/macOS/WSL you can use Clang.
Build with the Docker container:
docker build -t jsrf .
docker run -it --rm -u $(id -u):$(id -g) -v $PWD:/work -w /work jsrf /bin/bash -c "cmake -Bbuild -S. -DCMAKE_BUILD_TYPE=Debug -DCMAKE_TOOLCHAIN_FILE=toolchains/llvm.cmake && cmake --build build"Build on Windows with CMake and Visual Studio:
python3 -m pip install --user -r requirements.txt
cmake -AWin32 -Bbuild -S.
cmake --build buildBuild on Linux (Ubuntu) with CMake and Clang:
sudo apt install cmake clang lld python3-pip
python3 -m pip uninstall --user -r requirements.txt
cmake -Bbuild -S. -DCMAKE_TOOLCHAIN_FILE=toolchains/llvm.cmake
cmake --build buildBuild on macOS (works on both Intel and Apple Silicon macs) with CMake and Clang:
brew install llvm cmake
python3 -m pip install -r requirements.txt
export PATH="/opt/homebrew/opt/llvm/bin:/usr/local/opt/llvm/bin:$PATH"
cmake -Bbuild -S. -DCMAKE_TOOLCHAIN_FILE=$PWD/toolchains/llvm.cmake
cmake --build buildWhen the build is complete, the original game with re-implementation patched in will be at jsrf-patched/default.xbe. Use extract-xiso to create an ISO from your jsrf-patched directory, then run jsrf-patched.iso in xemu, or on your Xbox.
You'll want to set up a debug environment.
To create an executable with symbols when building with the LLVM toolchain, add -DCMAKE_BUILD_TYPE=Debug argument to CMake when configuring the project.
During the build process, a .gdbinit script is generated. This script will help initialize a gdb session for debugging. It will be loaded automatically when gdb is invoked from the current directory. You can launch xemu with a GDB server by passing the -s flag.
Interested in reversing the game? PRs are welcome!
The process of adding re-implemented functions is mostly automated and relatively painless:
- Add new function/data declarations to
kb.jsonas they are discovered and confirmed. The definitions inkb.jsonare used to automatically generate header files and link the new implementation with the original XBE. - Implement new functions in the appropriate source file
src/jsrf/**/*.c. Add new source files tosrc/CMakeLists.txt. - The build system will compile and patch the XBE with redirects from the original implementations to the re-implementations.
- Naturally, your new code will call some function in the original binary that has not yet been re-implemented. These functions will also be automatically linked correctly, provided the definitions of data and called functions are in
kb.json.