Rhythm Heaven Advance

An unofficial English localization patch for Rhythm Tengoku (リズム天国) on the Game Boy Advance.

About

Rhythm Heaven Advance is a fan-made localization project for Rhythm Tengoku. This project provides a complete English translation patch for the game.

Installation

Requirements

• A legally obtained ROM of Rhythm Tengoku (Rev 0) with CRC32 checksum: 349D7025
• An IPS patcher tool (recommended: ROM Patcher JS)

Steps

1. Download the latest .ips patch file from the Releases page
2. Open your IPS patcher tool
3. Select your Rhythm Tengoku ROM
4. Apply the downloaded patch
5. Load the patched ROM in your emulator or flashcard

Building from Source

Prerequisites

All platforms require:

• A legally obtained ROM of Rhythm Tengoku (Rev 0) (CRC32: 349D7025)
• Git

Windows

Use the Linux instructions via Windows Subsystem for Linux (WSL). Debian or Ubuntu distributions are recommended.

To set up WSL:

wsl --install

Then follow the Linux build instructions below.

Linux

Dependencies

Install the required packages (Ubuntu/Debian):

sudo apt-get update
sudo apt-get install build-essential binutils-arm-none-eabi git libpng-dev ffmpeg

Install devkitPro

# Download and install devkitPro pacman
wget https://apt.devkitpro.org/install-devkitpro-pacman
chmod +x ./install-devkitpro-pacman
sudo ./install-devkitpro-pacman

# Set environment variables
export DEVKITPRO=/opt/devkitpro
export DEVKITARM=/opt/devkitpro/devkitARM
export DEVKITPPC=/opt/devkitpro/devkitPPC

# Install GBA development tools
sudo dkp-pacman -Sy
sudo dkp-pacman -S gba-dev

Clone and Build

1. Clone this repository:

   git clone https://github.com/ShaffySwitcher/RhythmHeavenAdvance.git
   cd RhythmHeavenAdvance
   

2. Set up agbcc:

   git clone https://github.com/pret/agbcc.git
   cd agbcc
   ./build.sh
   ./install.sh ../RhythmHeavenAdvance
   cd ..
   

3. Place your ROM:

   • Copy your Rhythm Tengoku ROM into the project root directory
   • Rename it to baserom.gba (or as specified in the Makefile)

4. Build the project:

   make -j$(nproc)
   

The patched ROM will be generated in the build/ directory.

macOS

macOS build instructions are coming soon!

Credits

Check out the full credits here!

License

This project is licensed under the terms specified in LICENSE.txt.

The license covers the code I've written for this project, NOT any of the assets or other parts I haven't written. This is a fan-made patch and is not affiliated with or endorsed by Nintendo. You must own a legal copy of Rhythm Tengoku to use this patch.

For licensing inquiries, please see the Contact section.

All rights reserved concerning the assets to the original authors as it is unlicensed.

Contact

For questions, suggestions, or licensing inquiries:

• Discord: shaffyswitcher
• GitHub Issues: Report bugs or request features

Disclaimer

This is an unofficial fan project and is not affiliated with, endorsed by, or associated with Nintendo. All trademarks and copyrights belong to their respective owners. This patch is intended for personal use only with legally obtained copies of the game.