Romhacking

Tools, hacks, technical info about good old games.

Installation

Asar (65c816 assembler)

On Debian-based distributions, make sure you have build-essential and cmake installed.

git clone https://github.com/RPGHacker/asar
cd asar
cmake src && make
sudo cp asar/asar-standalone /usr/local/bin/asar

Python dependencies

Python >= 3.8 is recommended.

# Install dependencies inside a virtualenv.
# i.e.: mkvirtualenv romhacking
pip install -r requirements.txt

C++ libraries (for Star Ocean only)

Make sure you have Boost.Python installed (libboost-python-dev on Debian-based distributions).

cd romhacking
./compile.sh

Usage

# Extract.
./bin/evertool extract ORIGINAL_ROM TEXT_FILE

# Reinsert (creates a patched ROM file).
./bin/evertool reinsert ORIGINAL_ROM TEXT_FILE

Testing

# Install dev dependencies.
pip install -r requirements-dev.txt

# Make sure the original ROMs are in the test directories.
cp evermore.sfc evermore/tests/roms/
cp so.sfc starocean/tests/roms/

# Run tests.
pytest                 # Globally.
cd evermore && pytest  # Per package.