Scripted Scene Graphics

Navigation: Home - Graphics - Scripted Scene Graphics

Deep ASM trace of graphics-heavy scripted moments that are not plain OP_01–OP_07 text and not OP_0B shop signboards alone. Companion: 45-event-graphics-opcodes.md (event VM scope), 44-event-text-rendering.md, 08-event-runtime.md, 38-title-screen-and-intro-assets.md.

[TOC]

ASM: EXTRACTED/mm2.capstone.annotated.asm, A4 = $7FFE.

Short answer

Moment	Event VM (`event.dat`)	Separate engine
Corak spirit (3D view + ghost sprite + bottom text + SPACE + OPTIONS)	No matching triplet on loc 00; copy in loc 60 `str[8]`	Castle scripted-scene path: tile/area hooks → `play_song_scripted` + viewport sprite overlay (`0x316E` / mode `$16`/`$17`)
Guardian Pegasus first visit C2 `(4,7)`	loc 11 evt 04: party flag gate + `OP_0B` sign + `OP_03` dialogue + `OP_07`	Viewport sprite overlay — `monsters.dat` #131 (`picture=0x15`) → `21.anm` via `0x9A30`/`0x316E`/`0x23C8C` mode `$17` over outdoor 3D; not title `intro.32`
Title pegasus	—	`0x25FCE` / `0x26A1E` only (doc 39)

Critical distinction: In-game “illustration scenes” use the castle / scripted-scene subsystem (bytecode @ A4-$7232, draw @ 0x76AC, sprites @ 0x738C). The event VM only supplies string indices and OP_0B shop signs on walkable maps. Retail screenshots of Corak/Pegasus match the overlay subsystem, not a single opcode.

1. Two pipelines (do not conflate)

flowchart TB
  subgraph evm [Event VM — loc 0..59 walkable]
    scan[0x1754A tile scanner]
    interp[0x172CA OP_00..32]
    op01[OP_01..07 text]
    op0b[OP_0B → 0x316E sign .anm]
    scan --> interp --> op01
    interp --> op0b
  end

  subgraph castle [Castle / scripted-scene engine]
    q[0x176B6 queued id / loc 63·65·68]
    run[0x6FB8 bytecode runner]
    frame[0x77AA frame dispatch]
    draw[0x76AC scene draw step]
    song[0x64F8 play_song_scripted]
    spr[0x738C slot setup → 0x316E / 0x23C8C]
    q --> run --> frame --> draw
    frame --> song
    draw --> spr
  end

  subgraph shared [Shared viewport overlay]
    load[0x9A30 → NN.anm]
    place[0x3266 → mode 0x17 @ 0x23C8C]
    load --> place
  end

  op0b --> shared
  spr --> shared

Layer	Entry	Loads	Blit destination
Event text	`0x15924`–`0x15CE6`	loc string bank `A4-$47C8`	Rows 17–22 / popup cells (doc 44)
`OP_0B`	`0x15DB0`	`0x9A30(id)` → `NN.anm` (`0x316E` `subq` + `0x9A30` `addq` cancel)	Viewport `(8,8)–(215,127)` via `0x3266`/`0x23C8C`
Castle scene	`0x6FB8` / `0x76AC`	Scene table `A4-$72FC` / sheet handles `A4-$7366`	Full viewport or slot rects (see §3)
Scripted score + text	`0x64F8`	Pointer table `A4-$73C4` + `A4-$73C0`	Cleared band + `-$7BE4` strings + `0x6798` wait
Title attract	`0x25FCE`	Embedded `intro.32`, `introclips.32`	Full 320×200 (doc 38/39)

2. Shared viewport overlay (`0x316E` / `0x9A30` / mode `$17`)

Used by OP_0B, combat encounter setup (OP_12/13 → 0x316E), and castle scene slots (0x738C).

2.1 Load — `sign_sprite_load` @ `0x316E`

Optional viewport clear if dark (A4-$79E1): preset #8 @ (8,8)–(215,127).
Pick slot from A4-$7538 (24 bytes) matching sign/sprite id.
0x9A30(id) — builds NN.anm in scratch (0x316E subq #1 then 0x9A30 addq #1 before the decimal loop; net id unchanged), returns handle → A4-$79FE.
Gfx prep: -$7BAE with mode $16 (0x3220).

2.2 Place — `sign_sprite_place` @ `0x3266`

-$7BAE with mode $17 → 0x23C8C compositing.
Uses handle A4-$79FE (and secondary A4-$FCAC for layered blits).
OP_0B passes (pos, $40, $20) — placement index, not display mode (doc 45 §OP_0B note).
Cleanup @ 0x171AC: sign_sprite_place(-1,0,0) + buf_copy_rect restores viewport.

2.3 Corak “ghost” sprite

Retail: white spirit figure over the live 3D hood (walls/torches visible behind). That matches this overlay path (planar .anm on the 208×120 viewport), not a full-screen intro.32 replace and not OP_0B from a loc 00 script (no Corak triplet there).

Open: exact NN.anm index for the Corak spirit (dump 0x9A30 id table vs castle scene bytecode). Scene slot setup @ 0x738C sets object $1e ← $11, $1c ← 3, links sheet handle A4-$7356.

3. Castle scripted-scene engine

Separate from 0x172CA opcode dispatch. Drives loc 63 / 65 / 68 “castle blob” records, queued events (A4-$5D46 @ 0x176B6), and first-time / tile hooks.

3.1 Key A4 fields

Offset	Name	Role in scenes
`-$79AF`	`script_scene_index`	Index into `A4-$7232` bytecode pointer table (`0x6FB8`)
`-$79B0`	`script_scene_alt`	Secondary queue byte (save/restore @ `0x8484`)
`-$7958`	`run_scene_on_tile`	Set @ `0xCCB8`/`0xCD44` when a scene should run on event tile
`-$79E9`	`first_time_flag`	Set on area enter @ `0x6E84`; overland @ `0x2242` checks it
`-$7232`	`scene_script_ptrs[]`	Per-index bytecode stream pointers
`-$2AFE`	`tile_script_desc[]`	Tile-linked script descriptors (used @ `0x7B30`)
`-$730C` / `-$7366` / `-$7352`	Scene handles / active flags	`0x76AC` draw pipeline
`-$F00` / `-$F04` / `-$F08`	Scene object roots	Alloc @ `0x7070` (`0x264`-byte headers, 5 slots)
`-$73C4` / `-$73C0`	Scripted text/score tables	`play_song_scripted` @ `0x64F8`
`-$79FE`	Viewport overlay handle	Shared with `OP_0B` / scene sprites

3.2 Bytecode runner — `0x6FB8`

Loop while A4-$79AF / arg index < 0x0A:

Fetch stream pointer from A4-$7232[index].
Wait for key -$7BD2 if needed.
Read byte; if $FF, exit.
Read operand word from A4-$7252 table.
Call 0x77AA(operand, stream_state) — one scene “step”.

Called from the 0x7064 loop (same family as 0x6FB8 parent @ 0x6FB8 / area loader).

3.3 Frame player — `0x77AA` → `0x76AC`

0x77AA (args: scene type byte, timing):

For type < 0x64: divides tick @ 0x76AC — maps to score/script line via A4-$7326, A4-$734A, A4-$730C; calls 0x7532 (blit prep) or 0x738C (sprite slot) or 0x738C → -$7B18/-$7B24 (sheet blit).

0x76AC core step:

Index A4-$7366 sheet pointer, A4-$7352 active word.
0x7532: push A4-$F00 object, -$7B30 — mode $16-class prep on viewport.
0x738C: configure scene layer (types $1c, $1e, blit $22/$26, A4-$7356 handle) — this is where full illustration layers attach.

Full-viewport illustration (Pegasus): 0x728E path loads a wide sheet (pea $400, -$7B06) into scene object $e, then -$7B18 blit — consistent with 320×200-class art filling the playfield while chrome + bottom text remain (doc 15 composition). Filename is not hard-coded as intro.32 in the code hunk (loader uses data-hunk / scene table paths); retail art matches intro.32 frame 0 (doc 38).

3.4 Tile condition hooks — `0x78A8` chain

After 0x4BBC (tile class @ A4-$2AAA) and 0x7B46, the engine walks 0x78A8 → 0x790E → 0x795C → 0x79A0:

Routine	Condition (summary)	Calls `0x64F8(id)`
`0x78A8`	Descriptor type 1 and `A4-$79B2 ≠ 2`	id 3
`0x78A8`	Type 2 and `A4-$79B2 == 2`	id 2
`0x790E`	Byte `$80` set, outdoor `A4-$79E2==1`, solid @ `0x2BCC`	id 4
`0x795C`	Level gate vs object `$58`	id 5
`0x79A0`	HP gate vs `A4-$3F0A`	id 6

These are scripted score + text steps (table A4-$73C4), often paired with scene graphics on the same tile step — not replaceable by event VM opcodes alone.

3.5 `play_song_scripted` @ `0x64F8`

If A4-$79B2 == 2 (combat panel mode), shorten wait ($0F vs $14).
Clear message band: -$7F62, $26×$10 rows.
A4-$73C4[id×4] → first string; -$7BE4 draw; second string; footer from A4-$73C0.
Cursor -$7BFC, 0x6798(50) tick wait (SPACE flow).
Does not load .anm itself — graphics come from parallel 0x76AC/0x738C step or pre-placed overlay handle.

Also invoked from title path 0x1000 with id 0x12D (doc 25).

3.6 Area enter / first-time — `0x6E08` / `0x6E84`

0x6E08 (map/area transition handler):

Load area block via -$7C74, stash A4-$7A42, init 0x65FA, -$7E12 → screen id in -$2.
If -$2 ≠ $FFFF: set A4-$79E9 ← 1, save ptr A4-$47CC, jsr $CD90 ( lands in cast/scene cluster @ 0xCD7E–0xCD98 — see annotation @ 0xCD98), optionally 0x6DC6 if A4-$7958.
0x6DC6: adjust saved object timers $58/$5c, set A4-$79E8.

0x6DC6 + A4-$7958 bridge tile event bit (-$55D6 bit 1) to 0xCB52 scene prelude (clear band, -$7E42(9), wait 0x32) when -$7958 set @ 0xCCB8/0xCD44.

3.7 Queued event path — `0x176B6`

When A4-$5D46 ≠ $FF (doc 08):

Rebuild string anchor from work buf header bytes.
0x17262(queued_id) seek script in pool.
0x1754A re-init + run.

Used for loc 60–70 banks and castle blobs without normal 00 00 00 terminators.

4. Corak intro — end-to-end trace

4.1 Player-visible (FAQ + retail)

Item	Value
Copy	“The spirit of Corak proclaims, ‘Fantastic adventure awaits you…’”
FAQ tile	Middlegate `(7,4)` [FIRST TIME] (FAQ §3-2-2)
Engine tile	`(y,x) = (4,7)` if FAQ uses `(x,y)`
Screenshot	3D dungeon still drawn + ghost sprite on viewport + multi-line bottom text + SPACE + OPTIONS panel (`A4-$79B2 = 0`)

4.2 Where text lives

Source	Index / note
`event.dat` loc 60	`str[8]` — canonical string (loc_60)
loc 00 Middlegate	No script references `str[8]`; no `(4,7)` Corak triplet
loc 60 record	`string_bank` — 0 bytes in standard script pool; triplets are overlay placeholders (evt 116/118 @ `(0,0)` / pseudo tiles)

Related loc 60 strings: Nordon str[9] @ (10,2), Feldecarb str[23] @ (15,15) — also not wired as simple loc 00 scripts; same overlay / quest machinery.

4.3 Runtime path (confirmed partial)

Area enter / first visit (0x6E84)
  → first_time_flag (A4-$79E9)
  → scene cluster call (≈0xCD90 / cast UI 0xCC08)
  → optional run_scene_on_tile (A4-$7958) → 0xCB52 prelude
  → 0x6FB8 bytecode (A4-$7232[index])
       ├─ 0x76AC / 0x738C  → ghost .anm on viewport (0x316E / 0x23C8C)
       └─ 0x78A8 → play_song_scripted(3)  → loc 60 text via A4-$73C4 row
  → OP-like wait: 0x6798 / SPACE (same family as OP_07)

Not involved: title 0x26A1E pegasus loop; OP_0B on loc 00.

4.4 `play_song_scripted` / music / castle blobs

Link	Detail
`0x64F8`	Text + blocking wait; table `A4-$73C4`
`0x78E6`	`play_song_scripted(3)` when tile descriptor type 1 and not combat panel
loc 63 / 65 / 68	Castle blob pools — bytecode + pseudo triggers; feed `0x176B6` / `0x6FB8` (doc 08)
Score id 3	Scripted score row (not a simple 0..59 song index) — doc 25

4.5 Blit destination

Layer	Region
3D hood	Unchanged under/behind overlay (session refresh `0x5382` → `0x2ECE`)
Ghost sprite	Viewport `(8,8)–(215,127)` via `A4-$79FE`, mode `$17`
Text	Bottom panel rows 17–22 (same strip as `OP_02`/`OP_03`, doc 44)
Chrome	OPTIONS list `A4-$79B2 = 0` (doc 43)

5. Guardian Pegasus (C2 overland) — end-to-end trace

Sector note: Pegasus first visit is C2 (map screen 11), tile (4,7) ENTER — FAQ (7,4)^ uses (x,y) coords. C3 (map 14) only has the Meenu name clue (loc 14 evt 06 str[7]); it is not the Pegasus greeting tile.

5.1 Two layers on the same tile

FAQ (7,4)^ [FIRST TIME] = engine (4,7) ENTER — loc 11 evt 04 (loc_11).

Event VM (walkable loc 11):

apply_party(0x74, 0x40)     ; skip if “already seen pegasus” bit set
OP_0B  str[14]               ; wooden direction sign “<- Castle / Pinehurst”
OP_03  str[5]                ; “Greetings! I'm your Guardian Pegasus…” (tall block)
apply_party_masked(0x74, … or 0x40)   ; set seen flag
OP_07                        ; SPACE wait
OP_14                        ; clear tile event flag

Retail illustration: monsters.dat record #131 (Pegasus, byte 0x15 → picture & 0x7F = 21) loads 21.anm through the shared combat/sign overlay path:

loc 11 evt 04 tile (4,7) ENTER
  → party byte 0x74 bit 0x40 gate
  → event VM OP_0B + OP_03 + OP_07 (text/sign)
  → castle tile hook 0x78A8 chain (parallel scene step)
  → 0x738C slot setup → sign_sprite_load @ 0x316E
  → 0x9A30(20) builds "21.anm" (id−1 indexing)
  → sign_sprite_place @ 0x3266 → mode $17 blit @ 0x23C8C over 3D viewport (8,8)–(215,127)

Do not blit intro.32 for this beat — that sheet includes the title “Might and Magic Book Two” logo band (title-only @ 0x25FCE). introclips.32 is title attract only (doc 39).

5.2 Party flag gate

Field	Meaning
Roster / party byte `0x74`, bit `0x40`	“Seen Guardian Pegasus intro” — `apply_party` / `apply_party_masked` in evt 04
First visit	Flag clear → event + scene run
Return visit	`skip_tokens(4)` → entire evt 04 skipped

5.3 Protect panel

Screenshot Protect panel = A4-$79B2 = 1 (normal overland play default after intro). OP_07 wait loop uses key_read_3d in dungeon; overland uses -$7BD2 (doc 44 §3.7).

5.4 Other Pegasus mentions (not this illustration)

Place	Mechanism
B1 loc 06 `(9,9)`	Password “What is my name?” — text only
C3 loc 14	“Meenu” decode — text only
Title	`intro.32` + `introclips.32` — separate boot path

6. Asset filenames (traceable vs open)

Asset	Confirmed loader	Used for
`21.anm`	`0x9A30(20)`	Guardian Pegasus illustration — `monsters.dat` #131 `picture=0x15`
`NN.anm`	`0x9A30`	`OP_0B` signboards, combat sprites, Corak ghost (id TBD)
`intro.32`	Embedded string @ `0x26985`, `0x25FCE`	Title screen only — includes Book Two logo band
`introclips.32`	`0x26058`/`0x260DE`	Title pegasus cel animation only
Scene `.32` / `.anm`	`-$7B06`/`-$7CB6` via `A4-$72FC`	Castle blob / illustration scenes
loc 60 / 11 strings	`event.dat` only	Dialogue text indices

Not in code hunk ASCII: “corak”, “pegasus”, “spirit”, “intro” (except title load sites) — names come from disk files or event.dat.

7. Relation to death screen / endgame

Same overlay stack (0x316E, A4-$79FE, mode $17, cleanup 0x171AC) serves combat sprites and service signs. Endgame (loc 66 Corak soul / Murray / Horvath — loc_66) mixes OP_0E selectors and event VM; full-screen illustrated beats should be traced through 0x6FB8/0x64F8 on the same checklist as §3–4.

8. Remake plan (`game/`)

Phase A — Document & flag parity (now)

Party byte 0x74 bit 0x40 — pegasus seen (align evt 04 decode).
first_time_flag / loc 60 string str[8] — Corak prologue gate.
Keep TitleScreen.cpp title-only; do not wire title introclips into overland.

Phase B — `ScriptedSceneEngine` (new module)

Component	ASM reference	Remake API sketch
Scene queue	`A4-$79AF`, `0x6FB8`	`queueScene(index)`
Illustration blit	`0x76AC`/`0x728E`	`blitFullViewportSheet(sheet, frame)`
Sprite overlay	`0x316E`/`0x3266`/`0x23C8C`	`setViewportOverlay(anm, slot)`
Text + wait	`0x64F8`	`runScriptedLines(tableId, waitSpace)`
Cleanup	`0x171AC`	`clearOverlays()` + viewport restore blit

Phase C — Proof demos

Extend event_op_demo (see game/README.md) with:

corak_intro: 3D view + placeholder ghost .anm + loc 60 str[8] + SPACE.
pegasus_c2: outdoor C2 (4,7) base frame + 21.anm sprite + loc 11 str[5] OP_03 + Protect panel.

Requires 0x23C8C placement math and 0x9A30 id dump (open gaps).

Explicit non-goals

Do not implement Corak/Pegasus as OP_0B-only or text-op-only (doc 45 §Corak/Pegasus — superseded by this doc for illustration beats).
Do not map FAQ (7,4) to loc 00 evt 18 (4,7) Lock and Key — different content.

9. Open gaps

0x23C8C — pixel placement for mode $17 (sign + ghost parity). Partial remake: centered upper viewport + placement-index Y nudge; A4-$56E coord quads not in ghidra/mm2_data_00.bin extract.
0x9A30 / Corak ghost — candidate 51.anm (monster #170 Ghost picture=51); castle bytecode @ 0x738C still needs id confirm. Town OP_0B ids traced via 0x15756 tables A4-$6C62..$6C02 (dumped in game/src/events/ServiceSignResolver.cpp).
Corak (4,7) first-time — exact A4-$7232 index + castle blob record (63/65/68) emitting str[8] (loc 60 evt 116/118 candidates).
A4-$73C4 — dump scripted line pointers → loc 60 string cross-ref.
Pegasus illustration — confirmed: monster #131 → 21.anm via 0x9A30/0x316E/0x23C8C. Wide-sheet 0x728E path is title-adjacent only; do not use for in-game Pegasus.
jsr $CD90 @ 0x6E94 — lands in string padding @ 0xCD90; real entry cluster 0xCC08/0xCD98 needs IRA re-sync ([annotation @ 0xCD98).

10. Full scripted scene catalog

ASM-confirmed graphics + blocking text paths and their data sources. “Implemented” = game/src/events/ScriptedSceneEngine.cpp + GameSession::maybeQueueScriptedScenes as of 2026-06-10.

10.1 `play_song_scripted` @ `0x64F8` (table `A4-$73C4`, footer `A4-$73C0`)

Clears rows 38–61 (-$7F62, 38×16), draws two pointer-chained strings via -$7BE4, footer string, cursor -$7BFC, waits 0x6798(50). Does not load .anm/.32 — graphics are parallel 0x76AC/0x738C steps or a pre-placed A4-$79FE overlay.

Script id	ASM caller	Condition (summary)	Text source (confirmed / inferred)	Gfx asset	Remake
2	`0x7904`	Tile descriptor type 2 and `A4-$79B2 == 2` (combat panel)	`A4-$73C4[2]` — not dumped	Paired castle step	No
3	`0x78E6`	Descriptor type 1, not combat panel	loc 60 `str[8]` (Corak prologue) — cross-ref pending `-$73C4` dump	Ghost `51.anm` candidate @ `0x738C`	Partial (`CorakIntro`)
4	`0x7952`	Tile byte `$80`, outdoor `A4-$79E2==1`, solid @ `0x2BCC`	`A4-$73C4[4]` — TBD	Castle scene slot	No
5	`0x7990`	Party level < object field `$58`	`A4-$73C4[5]` — TBD	Castle scene slot	No
6	`0x79B6`	Party HP gate < `A4-$3F0A`	`A4-$73C4[6]` — TBD	Castle scene slot	No
0x12D (301)	`0x001028` / `0x002004`	Title attract loop	Title score table via `-$7B9C`/`-$7BA8` — not `0x64F8`	Title `intro.32` + `introclips.32`	Yes (`TitleScreen.cpp`)

Footer string near 0x644A in code hunk: *** Combat Only *** (also A4-$73C0 default row).

10.2 Castle bytecode runner @ `0x6FB8` (`A4-$7232`, draw @ `0x76AC` / `0x728E`)

Step	Routine	Role
Queue index	`A4-$79AF` / `A4-$79B0`	Select `A4-$7232[index]` bytecode stream
Runner	`0x6FB8`	Read op byte; operand @ `A4-$7252`; dispatch `0x77AA` until `$FF`
Frame tick	`0x77AA` → `0x76AC`	Sheet index `A4-$7366`, blit prep `0x7532`, sprite slot `0x738C`
Wide sheet	`0x728E` @ `0x7070`	`pea $400`, loader `-$7B06` — Pegasus `intro.32` class art (embedded path @ `0x728E` in scene init cluster)
Scene init	`0x7070`	Alloc 5×`0x264` scene objects; hook sheet filenames from `A4-$72FC`

Known scene moments using this stack:

Scene	Trigger	`A4-$79AF` index	Text	Gfx	ASM entry	Remake
Corak spirit	First-time area enter `0x6E84` → `jsr $CD90`; `A4-$7958` tile bit	TBD	loc 60 `str[8]` via `play_song_scripted(3)`	Ghost overlay `0x316E` / `$17`	`0x6E08` cluster, `0x6FB8`, `0x78E6`	Partial
Pegasus illustration	C2 first visit tile `(4,7)` ENTER; party `0x74` bit `0x40`; loc 11 evt 04	TBD	loc 11 `str[5]` OP_03 (+ evt `OP_0B` `str[14]` sign)	`21.anm` (monster #131) @ `0x738C`→`0x316E`→`0x23C8C` over outdoor 3D	`0x78A8`, `0x738C`, `0x316E`	Partial
Tile-hook scores 2–6	`0x78A8` → `0x790E` → `0x795C` → `0x79A0`	per hook	`A4-$73C4[id]`	Parallel `0x76AC` step	`0x78A8` chain	No

10.3 Queued overlay @ `0x176B6` (`A4-$5D46`)

When queued_event_id ≠ $FF: rebuild string anchor from work-buf header, 0x17262(id), re-init 0x1754A, run interpreter. Used for loc 60–70 records without normal 00 00 00 terminators and castle blobs.

Loc	Kind	Role	Pseudo-triggers / notes	Remake
60	string_bank	Corak / Nordon / Nordonna / Feldecarb copy	evt 116/118 @ `(0,0)` `cond=$FE` — overlay placeholders	Strings only
61	string_bank	Spell/hireling encoded tables + class-quest guide blurbs	Triplet table; no script pool	Strings only
62	string_bank	Chris sextant, Gertrude/Rat Fink	—	Strings only
63	castle_blob	Skill sellers, bar brawl, Lucindra shop tips	432 pseudo-tiles; embedded ASCII (e.g. Rinaldo diplomacy, Lucky Spade gambling)	No
64	string_bank	Lord Haart heirloom quest	—	Strings only
65	castle_blob	Gourmet / epicurean (+100k XP), Sherman rescue	265 pseudo-tiles	No
66	string_bank	Endgame: Corak soul, Murray, Horvath	Standard triplets	Event VM only
67	mixed_pool	Hall of Spells (opcodes > `0x32`)	Queued scripts	No
68	castle_blob	HoS class-requirement plaque text	250 pseudo-tiles (“Knights must defeat…”)	No
69	string_bank	Queen Lamanda Luxus storyline	—	Strings only
70	string_bank	HoS welcome, Hireling Hall, bishop puzzles	Yellow-interleave hint	Strings only

Decode: python tools/decode_event.py event.dat <loc>.

10.4 Related illustration / overlay moments (not castle bytecode)

Moment	Pipeline	Asset / text source	Remake
Title pegasus attract	`0x25FCE` / `0x26A1E`	`intro.32` + `introclips.32` cel overlays	Yes (`TitleScreen.cpp`)
OP_0B town signboards	`0x15DB0` → `0x316E` → `0x9A30`	`NN.anm` id from `A4-$6C62..$6C02` tables	Partial (`ServiceSignResolver`, evt demos)
Combat encounter sprites	`OP_12`/`OP_13` → `0x316E`	Monster `picture & 0x7F` → `NN.anm`	No
Copy protection	`0x26BC4` / `0x27096`	`globe.32` / `disk.32` XOR tables (`A4-$6476`)	No
Party death tone	`0x9F22` → `-$7E96`	Audio only (doc 26); same overlay stack as signs	No
Endgame beats	loc 66 strings + `OP_0E` selectors; illustrated beats TBD @ `0x6FB8`	loc 66 string bank	No
Class quests / HoS	Walkable loc scripts + loc 61 guides + blob 68 plaque	Per-class loc events (doc 37)	Event VM partial

10.5 Remake implementation matrix

Scene / subsystem	`ScriptedSceneEngine`	`GameSession` hook	Demo PNG
Corak intro	`CorakIntro` — ghost `51.anm` + loc 60 `str[8]`	Middlegate screen 0 on party launch	`event_demos/scripted_corak.png`
Pegasus C2	`PegasusC2` — `21.anm` (#131) + loc 11 `str[5]` OP_03 over outdoor 3D	Screen 11 tile `(4,7)` (`coordY=4`,`coordX=7`)	`event_demos/scripted_pegasus.png`
Title pegasus	— (title-only)	`TitleScreen`	—
Castle blobs 63/65/68	—	—	—
`play_song_scripted` ids 2,4,5,6	—	—	—
Queued loc 67 HoS pool	—	—	—

Demo bug fixed (2026-06-10): event_op_demo reused one ScriptedSceneEngine; after Corak, queueScene() was blocked by active() so Pegasus still drew Corak. armDemo() now ends any active scene first.

11. Tools & cross-refs

Resource	Use
loc_60	Corak / Nordon / Feldecarb strings
loc_11	Pegasus evt 04 decode
loc_63 / 65 / 68	Castle bytecode pools
`tools/decode_event.py event.dat 60`	Loc 60 raw decode
`EXTRACTED/decomp/mm2_gamestate.h`	`A4` field constants
45-event-graphics-opcodes.md	Event VM graphics opcodes
44-event-text-rendering.md	Text rows / OP_07 / cleanup

Generated 2026-06-10 from mm2.capstone.annotated.asm trace + retail behavior + FAQ tile cross-check.

Page	Why
Event Graphics Opcodes	OP_0B in-game sprites
Title Screen Animation	Shared pegasus art path
Known Songs Catalog	play_song_scripted ids
Event Script Opcodes	Scene trigger opcodes

Scripted Scene Graphics

Scripted Scene Graphics

Short answer

1. Two pipelines (do not conflate)

2. Shared viewport overlay (0x316E / 0x9A30 / mode $17)

2.1 Load — sign_sprite_load @ 0x316E

2.2 Place — sign_sprite_place @ 0x3266

2.3 Corak “ghost” sprite

3. Castle scripted-scene engine

3.1 Key A4 fields

3.2 Bytecode runner — 0x6FB8

3.3 Frame player — 0x77AA → 0x76AC

3.4 Tile condition hooks — 0x78A8 chain

3.5 play_song_scripted @ 0x64F8

3.6 Area enter / first-time — 0x6E08 / 0x6E84

3.7 Queued event path — 0x176B6

4. Corak intro — end-to-end trace

4.1 Player-visible (FAQ + retail)

4.2 Where text lives

4.3 Runtime path (confirmed partial)

4.4 play_song_scripted / music / castle blobs

4.5 Blit destination

5. Guardian Pegasus (C2 overland) — end-to-end trace

5.1 Two layers on the same tile

5.2 Party flag gate

5.3 Protect panel

5.4 Other Pegasus mentions (not this illustration)

6. Asset filenames (traceable vs open)

7. Relation to death screen / endgame

8. Remake plan (game/)

Phase A — Document & flag parity (now)

Phase B — ScriptedSceneEngine (new module)

Phase C — Proof demos

Explicit non-goals

9. Open gaps

10. Full scripted scene catalog

10.1 play_song_scripted @ 0x64F8 (table A4-$73C4, footer A4-$73C0)

10.2 Castle bytecode runner @ 0x6FB8 (A4-$7232, draw @ 0x76AC / 0x728E)

10.3 Queued overlay @ 0x176B6 (A4-$5D46)

10.4 Related illustration / overlay moments (not castle bytecode)

10.5 Remake implementation matrix

11. Tools & cross-refs

See also

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

2. Shared viewport overlay (`0x316E` / `0x9A30` / mode `$17`)

2.1 Load — `sign_sprite_load` @ `0x316E`

2.2 Place — `sign_sprite_place` @ `0x3266`

3.2 Bytecode runner — `0x6FB8`

3.3 Frame player — `0x77AA` → `0x76AC`

3.4 Tile condition hooks — `0x78A8` chain

3.5 `play_song_scripted` @ `0x64F8`

3.6 Area enter / first-time — `0x6E08` / `0x6E84`

3.7 Queued event path — `0x176B6`

4.4 `play_song_scripted` / music / castle blobs

8. Remake plan (`game/`)

Phase B — `ScriptedSceneEngine` (new module)

10.1 `play_song_scripted` @ `0x64F8` (table `A4-$73C4`, footer `A4-$73C0`)

10.2 Castle bytecode runner @ `0x6FB8` (`A4-$7232`, draw @ `0x76AC` / `0x728E`)

10.3 Queued overlay @ `0x176B6` (`A4-$5D46`)