# Alleyway: annotated Game Boy disassembly and decompilation

> Alleyway documents a Game Boy disassembly and experimental C decompilation of the game's World ROM revision. It names roughly 200 functions and reports findings about an unused tilemap routine, serial-port-based RNG seeding and a paddle wall-clip bug; RGBDS commands assemble the ROM.

- 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/islander0/alleyway-decomp>
- Primary source: <https://github.com/islander0/alleyway-decomp/blob/f7b0a5e63bbfcf722ff2c1a8d76e51a688c73864/README.md>
- Catalog page: <https://awesomerea.org/resources/alleyway-game-boy-decomp-case/>
- Record JSON: <https://awesomerea.org/resources/alleyway-game-boy-decomp-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/alleyway-game-boy-decomp-case/index.md)

## Requirements & limits

- **Prerequisites:** Use RGBDS to assemble and link the source; the documented World Rev A ROM can be used to compare the result.
- **Limits:** The ROM is not included; some data remains unnamed and the C decompilation is exploratory.
- **License:** MIT license.

## Primary sources

1. <https://github.com/islander0/alleyway-decomp/blob/f7b0a5e63bbfcf722ff2c1a8d76e51a688c73864/README.md>
2. <https://github.com/islander0/alleyway-decomp/blob/f7b0a5e63bbfcf722ff2c1a8d76e51a688c73864/LICENSE>

## More in Games

- [Amplitude: a PS2 decompilation in progress](https://awesomerea.org/resources/amplitude-2003-case/index.md) · Case study
- [Angry Birds Decompilation: Lua script recovery](https://awesomerea.org/resources/angry-birds-decomp/index.md) · Case study
- [AutoDestruct-xport: a native port of Auto Destruct](https://awesomerea.org/resources/autodestruct-xport-case/index.md) · Case study
- [AutoZone Hot Pursuit: reconstructing Need for Speed: Hot Pursuit](https://awesomerea.org/resources/autozone-hot-pursuit-case/index.md) · Case study
- [AZHS: reconstructing Need for Speed: High Stakes 4.50](https://awesomerea.org/resources/azhs-case/index.md) · Case study
- [Babil Decompilation Project: Final Fantasy IV 3D Remake source reconstruction](https://awesomerea.org/resources/babil-decompilation-project-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.