# Sonic the Hedgehog: a generated Sega Master System disassembly

> Sonic the Hedgehog disassembles the Sega Master System game from a user-supplied ROM. A Python unpacker and annotation file generate Z80 assembly, which WLA-DX assembles into an output ROM; the repository also includes ROM asset-location and level-viewing tools.

- 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/iamgreaser/s1smsdisasm-gm>
- Primary source: <https://github.com/iamgreaser/s1smsdisasm-gm/blob/91e9dd6f77393cd820efd5785229141b525f56b2/README.txt>
- Catalog page: <https://awesomerea.org/resources/sonic-master-system-disassembly-case/>
- Record JSON: <https://awesomerea.org/resources/sonic-master-system-disassembly-case/record.json>
- Chinese version: [简体中文](https://awesomerea.org/zh/resources/sonic-master-system-disassembly-case/index.md)

## Requirements & limits

- **Prerequisites:** Supply the Sega Master System Sonic the Hedgehog ROM as baserom/sonic1.sms.
- **Prerequisites:** WLA-DX, Python 3, GNU Make and mypy are required for the documented build.
- **Limits:** The disassembly is a work in progress, and the asset-location tool is described as out of date.
- **License:** No licence file in the repository.

## Primary sources

1. <https://github.com/iamgreaser/s1smsdisasm-gm/blob/91e9dd6f77393cd820efd5785229141b525f56b2/README.txt>
2. <https://github.com/iamgreaser/s1smsdisasm-gm/blob/91e9dd6f77393cd820efd5785229141b525f56b2/Makefile>

## More in Games

- [SonsOfSparta-PS5 Native: God of War running on Windows](https://awesomerea.org/resources/sons-of-sparta-ps5-native-case/index.md) · Case study
- [Speedos: a black-box replica of the Spe_ed game model](https://awesomerea.org/resources/speedos-case/index.md) · Case study
- [spikewall: reconstructing the Sonic Runners server](https://awesomerea.org/resources/spikewall-case/index.md) · Case study
- [Splitgate Backend: a local replacement for game service endpoints](https://awesomerea.org/resources/splitgate-backend-case/index.md) · Case study
- [SR1 Creator: rebuilding the Saints Row character creator](https://awesomerea.org/resources/sr1-creator-case/index.md) · Case study
- [Star Fox: a matching SNES sound-driver disassembly](https://awesomerea.org/resources/star-fox-spc-driver-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.