# guzzler-disasm: a commented game disassembly

> guzzler-disasm documents a game through dissected, commented assembly and hardware, RAM and graphics definitions. Its Makefile builds a ROM from the disassembly, while a comparison script checks the result against the original. A planned web view for screens and sprites is marked TODO.

- 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/vinheim3/guzzler-disasm>
- Primary source: <https://github.com/vinheim3/guzzler-disasm/blob/6118c329a51084e3b08aca014371e5894eab8f36/README.md>
- Catalog page: <https://awesomerea.org/resources/guzzler-disasm-case/>
- Record JSON: <https://awesomerea.org/resources/guzzler-disasm-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/guzzler-disasm-case/index.md)

## Requirements & limits

- **Prerequisites:** Place guzzler.sg in the tools/ and web/ directories.
- **Limits:** The web list of game screens and sprites is marked TODO.
- **License:** No licence file in the repository.

## Primary sources

1. <https://github.com/vinheim3/guzzler-disasm/blob/6118c329a51084e3b08aca014371e5894eab8f36/README.md>

## More in Games

- [Habbo: a Flash-client server emulator](https://awesomerea.org/resources/habbo-flash-server-case/index.md) · Case study
- [HamHamGamesDecomp: an early Hamtaro GBA disassembly](https://awesomerea.org/resources/hamhamgames-decomp-case/index.md) · Case study
- [Hamtaro in Pieces: an incomplete Game Boy Color disassembly](https://awesomerea.org/resources/hamtaro-in-pieces-case/index.md) · Case study
- [Harrier Attack: a SkoolKit ZX Spectrum disassembly](https://awesomerea.org/resources/harrier-attack-disassembly-case/index.md) · Case study
- [Haxball Rooms API: decoding the binary room listing](https://awesomerea.org/resources/haxball-rooms-api-case/index.md) · Case study
- [hearthstone-deck-format: mapping Hearthstone deck strings](https://awesomerea.org/resources/hearthstone-deck-format-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.
