Use when implementing S3K animated tile triggers for a zone -- AniPLC script registration, gating conditions, dynamic art overrides in Sonic3kPatternAnimator.
Use when implementing or validating S3K palette cycling (AnPal handlers) for a zone -- counter/step/limit cycling, palette line targets, ROM data verification in Sonic3kPaletteCycler.
Use when starting work on a new S3K zone to catalogue its features from the disassembly. Reads Dynamic_Resize, Deform, AniPLC, and AnPal routines and produces a structured zone analysis spec.
Use when bringing up a new S3K zone — orchestrates analysis, parallel feature implementation (events, parallax, animated tiles, palette cycling), merge, and validation for a target zone.
Use when implementing S3K zone event handlers — camera locks, boss arenas, cutscenes, act transitions, palette mutations. Ports Dynamic_Resize routines from the disassembly.
Use when validating S3K zone feature implementations — captures stable-retro reference screenshots and compares against engine output using image recognition for feature presence verification.
Record Sonic 1 physics traces using stable-retro (cross-platform Python). Produces output identical to BizHawk Lua recorder for Java trace replay tests.
Use when implementing S3K zone parallax scroll handlers — deform routines, HScroll tables, scatter-fill, water splits, dynamic BG changes.