https://github.com/andreaorru/romhacking

Tools, hacks, technical info about good old games
https://github.com/andreaorru/romhacking

reverse-engineering romhacking snes

Last synced: 2 months ago
JSON representation

Tools, hacks, technical info about good old games

• Host: GitHub
• URL: https://github.com/andreaorru/romhacking
• Owner: AndreaOrru
• Created: 2015-04-02T21:46:36.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2024-01-21T07:02:47.000Z (11 months ago)
• Last Synced: 2024-10-05T14:45:17.755Z (3 months ago)
• Topics: reverse-engineering, romhacking, snes
• Language: Python
• Homepage:
• Size: 317 KB
• Stars: 15
• Watchers: 5
• Forks: 2
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# 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.

```bash

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.

```bash

# 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).

```bash

cd romhacking

./compile.sh

```

## Usage

```bash

# Extract.

./bin/evertool extract ORIGINAL_ROM TEXT_FILE

# Reinsert (creates a patched ROM file).

./bin/evertool reinsert ORIGINAL_ROM TEXT_FILE

```

## Testing

```bash

# 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.

```