# Hybrid Heaven: an AI-assisted matching N64 decompilation

> Hybrid Heaven reconstructs the 1999 Nintendo 64 game as C that is compared byte for byte with a user-supplied ROM. The repository includes function matching, register tracing, ROM packing and agent orchestration tools, plus per-batch research on model-assisted decompilation. The author reports 78.75% of code bytes matched at the stated update.

- Type: Case study
- Targets: Game
- Category: Independent reconstruction cases
- Relationship: Independent reconstruction project
- Sources reviewed: 2026-11-06
- Added to the catalog: 2026-11-09
- Original resource: <https://github.com/southcitycapture/hybridheaven-decomp>
- Primary source: <https://github.com/southcitycapture/hybridheaven-decomp/blob/68206935389f843c51a1fd38a7e87588d98c6a3b/README.md>
- Catalog page: <https://awesomerea.org/resources/hybrid-heaven-decomp-case/>
- Record JSON: <https://awesomerea.org/resources/hybrid-heaven-decomp-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/hybrid-heaven-decomp-case/index.md)

## Requirements & limits

- **Prerequisites:** A user-supplied Hybrid Heaven (USA) ROM is required.
- **Prerequisites:** Linux or WSL, Python 3.10+, git, curl, make and MIPS binutils are required.
- **Limits:** The author reports 78.75% of code bytes and 13.82% of source files fully linked at the stated update.
- **License:** CC0-1.0 license.

## Primary sources

1. <https://github.com/southcitycapture/hybridheaven-decomp/blob/68206935389f843c51a1fd38a7e87588d98c6a3b/README.md>

## More in Games

- [Hybrid: matching reconstruction of the Japanese PlayStation executable](https://awesomerea.org/resources/hybrid-ps1-decomp-case/index.md) · Case study
- [Hyper Street Fighter Zero Gold: byte-matched PS2 source recovery](https://awesomerea.org/resources/hyper-street-fighter-zero-gold-case/index.md) · Case study
- [hyperblade-decomp: matching HyperBlade's Windows executable](https://awesomerea.org/resources/hyperblade-decomp-case/index.md) · Case study
- [ICO decompilation: byte-identical PAL and Japanese PlayStation 2 boot ELFs](https://awesomerea.org/resources/ico-matching-decomp-case/index.md) · Case study
- [Illbleed decomp: reconstructing the Dreamcast executable](https://awesomerea.org/resources/illbleed-decomp-case/index.md) · Case study
- [Imperialism: reconstructing the 1997 game in C++ and Rust](https://awesomerea.org/resources/imperialism-decomp-case/index.md) · Case study

## About this entry

The description was reviewed against primary sources.
Original editorial content: MIT. Linked projects, papers and assets retain their own rights and licenses.