Case study

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.

Targets: Game
Category: Independent reconstruction cases
Relationship: Independent reconstruction project
Sources reviewed: 2026-11-06

Stars: 3
Last commit: 2026-05-22
Language: Assembly
License (GitHub): MIT

GitHub data as of 2026-11-09

Copy as Markdown View JSON Cite

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.

Cite

BibTeX

@misc{alleyway-game-boy-decomp-case,
  title = {{Alleyway: annotated Game Boy disassembly and decompilation}},
  howpublished = {\url{https://github.com/islander0/alleyway-decomp}},
  url = {https://github.com/islander0/alleyway-decomp},
  urldate = {2026-11-06},
  note = {Awesome REA entry: \url{https://awesomerea.org/resources/alleyway-game-boy-decomp-case/}}
}

Plain text

Alleyway: annotated Game Boy disassembly and decompilation. https://github.com/islander0/alleyway-decomp (accessed 2026-11-06). Awesome REA entry: https://awesomerea.org/resources/alleyway-game-boy-decomp-case/

Useful? Star Awesome REA on GitHub2.4k

About this entry

The description was reviewed against primary sources.

Report an outdated entry Suggest a translation fix

Primary sources

README.md GitHub · islander0/alleyway-decomp · Revision f7b0a5e
LICENSE GitHub · islander0/alleyway-decomp · Revision f7b0a5e