How anthonyjclarke/shadow-skimmer works
This repository is a commented, reassemblable disassembly of the ZX Spectrum game Shadow Skimmer, accompanied by catalogs and a behavior specification. The main reader workflow is to use the annotated listing and supporting pages to understand the game’s behavior, graphics, screens, and sound. The README documents simulator-based rendering and exact snapshot reconstruction; sampled source confirms the screen-map renderer and snapshot/tune utilities. Most listing and catalog implementation files were not sampled, so those documented capabilities are shown without guessing their internal call structure.
Main entry points: screens.py Hull-map renderer · tune_player.py Tune decryptor · shadskim.ctl Annotated listing · graphics.ref Graphics catalog
Components 15
Disassembly reference
- Annotated listing
src/shadskim.ctl - Listing annotations
src/shadskim.ref - Tune listing
src/tune.ctl - Glossary
src/glossary.ref
Game catalogs
- Graphics catalog
src/graphics.ref - Screens catalog
src/screens.ref - Hull-map renderer
src/screens.py - Sound catalog
src/sound.ref - Workspace page
src/workspace.ref
Behavior reference
- Behavior specification
spec/index.md
Snapshot utilities
- Snapshot codec
tools/z80snap.py - Tune decryptor
tools/tune_player.py
Other components
- Engineer / reader
- Game snapshot
- SkoolKit simulator
Connections 16
- Engineer / reader → Annotated listing: consults
README.md - Engineer / reader → Graphics catalog: consults
README.md - Engineer / reader → Screens catalog: consults
README.md - Engineer / reader → Sound catalog: consults
README.md - Engineer / reader → Workspace page: consults
README.md - Engineer / reader → Glossary: consults
README.md - Engineer / reader → Behavior specification: consults
README.md - Annotated listing → Listing annotations: annotated by
- Hull-map renderer → SkoolKit simulator: renders through
src/screens.py - Hull-map renderer → Screens catalog: tiles renders for
src/screens.py - Snapshot codec → Game snapshot: rebuilds
tools/z80snap.py - Tune decryptor → Snapshot codec: unpacks with
tools/tune_player.py - Tune decryptor → Tune listing: produces bytes for
tools/tune_player.py - Game snapshot → SkoolKit simulator: runs in
- Graphics catalog → SkoolKit simulator: renders through
README.md - Sound catalog → SkoolKit simulator: renders through
README.md