How sonicretro/s1disasm works
This repository is a disassembly of the 16-bit Sonic the Hedgehog game, accompanied by SonLVL object-definition utilities for level editing. The principal product workflow is editing level/object data and game assets, then assembling the game into a playable result; the README identifies the repository as a disassembly but does not document that workflow in detail. The graph preserves the major runtime, content, and asset areas visible in the tree. Dashed links indicate plausible relationships not verified in the supplied excerpts; sampled SonLVL definitions directly show their asset-loading relationships.
Main entry points: Level Drawing (REV00).asm Level engine · _incObj Level objects · ExecuteObjects.asm Object runtime · levels Level data
Components 20
Game runtime
- Sonic behavior
_incObj/01 Sonic.asm - Object runtime
_inc/ExecuteObjects.asm - Level engine
_inc/Level Drawing (REV00).asm - Special stages
_inc/Special Stage Loading & Drawing.asm - HUD and pause
_inc/HUD Update.asm - Sound routines
_inc/Queue Sound Routines.asm
Game content
- Level objects
_incObj - Sonic animation
_anim/Sonic.asm
Game assets
- Object mappings
_maps - Animation data
_anim - Compressed art
artnem - Level data
levels - Music and effects
sound - Shared object maps
_maps - Shared object art
artnem
Level editing
- Object definitions
Utility Project Files/SonLVL INI Files - Ring definition
Utility Project Files/SonLVL INI Files/Common/Ring.cs - Spikeball definition
Utility Project Files/SonLVL INI Files/LZ/Spikeball.cs
Other components
- Level editor user
- Playable game
Connections 18
- Level editor user → Object definitions: edits objects
- Ring definition → Shared object art: loads art
Utility Project Files/SonLVL INI Files/Common/Ring.cs - Ring definition → Shared object maps: maps sprites
Utility Project Files/SonLVL INI Files/Common/Ring.cs - Spikeball definition → Shared object art: loads art
Utility Project Files/SonLVL INI Files/LZ/Spikeball.cs - Spikeball definition → Shared object maps: maps sprites
Utility Project Files/SonLVL INI Files/LZ/Spikeball.cs - Object definitions → Level data: edits placements
- Level data → Level engine: supplies levels
- Level engine → Object runtime: dispatches objects
- Object runtime → Level objects: runs objects
- Sonic behavior → Object runtime: interacts with
- Sonic animation → Animation data: uses animation
- Special stages → Level data: loads layouts
- HUD and pause → Sonic behavior: shows status
- Sound routines → Music and effects: plays audio
- Level engine → Compressed art: loads graphics
- Level objects → Object mappings: draws mappings
- Level objects → Animation data: uses animation
- Level engine → Playable game: contributes runtime