Files
disasm/MAPPER8/Mermaids of Atlantis (U)/labelmap.tsv
T
tmerritt 691b2bc23c Xevious (U): Pass 1 disassembly
The first _wip project to get a real disassembly.  4,165 instructions /
8,444 code bytes (25.8%), 24,324 data bytes, 0 unclassified -- every byte
of the 32 KB PRG is now classified as code or data.

The split needed three stages, all recorded in prg.s's header:

  * nesdis.py --undocumented --auto-seed at base $8000 gave 3,272
    instructions / 6,555 bytes.  The undocumented opcodes matter here: the
    trace stops dead at the first one it cannot decode.
  * Four hand-seeded entries ($C08B, $DC1E, $E0D5, $E134).  Each is a
    branch target from decoded code that sat inside an untraced data run,
    so the tracer never reached it.
  * A merged four-session Mesen Code Data Logger capture (kept as
    xevious_mesen.cdl) promoted 1,902 bytes from data to code and
    demoted 22 the trace had called code.

Two tool bugs fell out and are fixed here:

  * nesdis.py emitted the undocumented single-byte NOPs ($1A/$3A/$5A/
    $7A/$DA/$FA) as `nop`, which ca65 assembles as the *official* $EA --
    the rebuild stopped being byte-identical at $DF82.  The check now
    keys on the opcode byte, not just the addressing mode.  All three
    `make regen` pipelines (MUSCLE, Pyramid, Urban Champion) are
    unaffected and still reproduce prg.s byte for byte.

  * cdl_reclass.py left the original data-block header in place when the
    CDL split that block, so the file ended up with two region headers
    describing overlapping spans (20 of them here).  The header is now
    dropped with the block it describes; the promoted projects that use
    the tool are byte-for-byte unchanged.

The project README has the power-on flow analysis.  The most interesting
find is at $FC45: the reset path compares RAM $0100-$0107 against the
ASCII string "Kei Cros", and the copyright text at $FF1E reads
"MAIN: KEI CROSS.  SOUND: UHOHOY OHNOGI."  The OAM is at $0700, not
$0200 -- the NMI handler does LDA #$07 / STA $4014.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Add explicit `make wip` / `make wipclean` targets for the _wip tier

The root Makefile's all / clean / <MAPPER> targets deliberately name only
the promoted mapper folders, so nothing in them reaches into _wip/.  Give
the pre-promotion tier its own opt-in targets instead of the manual
`for d in _wip/*/*/; do make -C "$d"; done` loop:

  make wip          # build + verify every _wip/<MAPPER>/<Project>/
  make wipclean     # clean the build artifacts in that tier

Both the Makefile and the four documents that describe the tier (README,
TODO, WIP, AGENTS) are updated together, so the tree stays consistent.

The same commit records Xevious (U) reaching Pass 2 in those documents:
all 487 labels named, every branch and call symbolic, zero Label_XXXX and
zero raw $XXXX operands left.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Update the _wip/ tier documentation; fix the make wip target and the mirroring bug

The WIP tier's four documents (WIP.md, README.md, TODO.md, AGENTS.md) had
drifted away from the tree.  Every number in them was re-derived from the
ROMs and the folder layout rather than carried forward.

Counts and structure
  - The tier holds 854 projects across 29 mapper folders, not "856 across
    30".  Xevious (U) and Zanac (U) were promoted on 2026-10-20 and their
    _wip/ folders were left behind as residue -- "git mv" moves only the
    tracked files, so the old folder survived with its build artifacts and a
    stale README.  Both are removed now; the promotion procedure documents
    the step so it does not recur.
  - _wip/MAPPER8/ holds a copy of the already-promoted Mermaids of
    Atlantis (U) and is excluded from every count and table.
  - Pass 0 skeletons: 852 (was 855).  Xevious (U) left the tier, so the
    two projects with a real disassembly are Golf (JU) and Volleyball (U).
  - PRG sizes 2 / 150 / 42 / 522 / 127 / 10 / 1; 226 projects with no CHR;
    38 keep the CPU-address linker layout; 37 are mapper 0.
  - Every inventory row was re-checked against its ROM: PRG/CHR size,
    mirroring, all three vectors, and the battery / four-screen / footer
    notes.  854 of 854 rows now match.

Fixes
  - The root Makefile used $(WIP) but never defined it, so "make wip" and
    "make wipclean" expanded to "for m in /*/" -- they walked the
    filesystem root instead of the tier.  "WIP := _wip" is now defined, and
    "make wip" builds and verifies the whole tier: 855 of 855 passed, 0
    failures.
  - make_skeleton.py masked header byte 6 with 0x03, so the battery bit
    (bit 1) leaked into the mirroring value and 56 battery-backed ROMs'
    READMEs claimed "Four-screen" while their own "Four-screen VRAM" row
    said "no".  The mask is now 0x01 and the 56 READMEs are corrected.
  - Golf (JU)'s README still described the pre-flatten copilot/ folder and
    the old PRG-only compare; it now describes the whole-ROM build.
  - Pyramid (U)'s audit comments are canonical again, so Golf (JU) is the
    only project in the tree still on the pre-canonical spelling.

New in WIP.md
  - Byte 7's lower nybble is non-zero on 58 of the ROMs -- 55 carry the
    literal "DiskDude!" watermark, two "DisNi0330", one "byKH+KEN".  Only
    the upper nybble carries mapper bits, so the noise is harmless.
  - The twelve ROMs that set the four-screen bit, split by whether their
    board actually supports four-screen VRAM.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Promote Volleyball (U) from _wip/NROM/ to NROM/

Volleyball (U) reached Pass 3 before promotion, so this is a promotion of a
finished disassembly rather than a Pass 0 skeleton.

The disassembly
  - 11,395 instructions / 23,926 code bytes (73.0 % of the PRG image),
    8,842 data bytes, 0 unclassified.
  - The split needed the game-state dispatch table at $85E1 declared to the
    tracer (--table 85E1:11) -- without it only 66 % of the image traced --
    plus a Mesen Code Data Logger capture taken while a random-input bot
    played the attract demo, which promoted 1,757 bytes from data to code.
  - Pass 2 named all 1,989 labels: 730 read out of the code by hand, 1,221
    internal branch targets derived mechanically.  Zero Label_XXXX, zero raw
    $XXXX call or branch operands, zero SubC residue.
  - Pass 3 named the zero page, the $0500 ball structure and all 37 data
    blocks.  apply_symbols.py --report: 0 pending substitutions, 0
    multi-alias residue.  align_audit_comments.py: no column drift.
  - cdl_check.py cross-checks the finished prg.s against the capture: 0
    CDL-code bytes not covered by an instruction, 0 CDL-data bytes that
    start one.
  - 29 neutral ZpXX zero-page slots remain, each with its reason recorded
    in locals.inc, as the promotion rules allow.

The promotion
  - git mv "_wip/NROM/Volleyball (U)" "NROM/Volleyball (U)".  Mapper 0, so
    it lands in NROM/.  The whole-ROM build was already in place, so there
    was no build surgery; the project builds byte-identically at its new
    home and the old folder is gone (git mv moves the untracked build
    artifacts too, so no residue was left behind).
  - Root README.md: new inventory row 39 and a per-project detail section,
    plus the WIP-tier counts.  The detail sections for Xevious (U) and
    Zanac (U) were numbered one too high against the inventory rows and
    are now aligned; a leftover editing note in the same place is gone.
  - WIP.md: the Volleyball row leaves the inventory, and the tier is now
    853 projects across 29 mapper folders (36 in _wip/NROM/), 852 of them
    Pass 0 skeletons.  Golf (JU) is the only project left in the tier with
    a real disassembly.
  - TODO.md and AGENTS.md: the same counts, and the promoted tier is now
    40 projects (39 under NROM/).

Verified: make wip builds and verifies the whole tier (854 of 854 passed,
0 failures) and make builds the promoted tier (39 of 39 passed).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Rename NROM/Pyramid (U) to NROM/Pyramid (U) (Sachen)

The promoted inventory row had read "Pyramid (U) (Sachen)" since the
project was promoted on 2026-10-20, but the folder was named "Pyramid (U)" --
so the row pointed at a folder that did not exist.  The folder now matches
the row, and the project's own README title, its ROM file name
("Pyramid (U) (Sachen).nes") and the parenthetical convention the rest of
the promoted tier already uses (Popeye (JU) (PRG 0/1), Raid on Bungeling
Bay (U) [a2], Pac-Man (Tengen) (U)).

What changed inside the project
  - The Makefile's regen target passes --project "Pyramid (U) (Sachen)", so
    the tracer writes the matching header line.  prg.s and locals.inc were
    updated to that header line and nothing else -- the disassembly is
    byte-identical to before.
  - make regen still reproduces prg.s and locals.inc byte for byte.
  - The project's README's build-verification line now names the new folder.

References updated: the root README.md (inventory prose, the row-33 detail
section, the build-status table, and the notable-observations bullet),
TODO.md (the promoted-projects table and the Pyramid notes) and AGENTS.md
(the recently-promoted list and the unlicensed-titles quirk).

Verified: make builds the promoted tier (39 of 39 passed) and the project
rebuilds byte-identically at its new path.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Rebuild Mermaids of Atlantis (U): bank-aware Pass 1, Pass 2/3 names

The promoted project did not build: a Pass 2 rename had been applied
half-way, leaving eight undefined symbols and two jumps that pointed at
the wrong routine, while the root README already claimed the project was
byte identical.  The _wip copy still built, because it held the un-renamed
Pass 1 source.

The disassembly is now derived from the ROM itself, with the Mesen Code
Data Logger as the oracle for the code/data split:

* _tools/banked_dis.py traces every MMC3 bank separately, each with the CPU
  window it is visible at, seeded from a CDL capture so the code a static
  trace cannot reach is disassembled too.  The CDL is the authority: a
  decode the CPU never fetched is dropped, and so is the fall-through
  behind a call whose target never returns (the game's dispatchers have
  their jump table right behind the call).
* One segment per bank (PRG0..PRG7) with its own .org, so the assembler
  knows the CPU address of every label while the linker still writes the
  bytes to the bank's file offset.  A flat segment cannot do both: a call
  would encode the file offset instead of the CPU address.
* Pass 2 names every label - 494 routines, no Label_XXXX and no raw
  $XXXX branch or jump operand left.  Pass 3 applies 13 semantic zero-page
  aliases and writes the routine headers.
* 8,075 bytes of code (12.3% of the 64 KB PRG), up from 200 bytes.

The banking turned out to be unusual and is documented: the fixed bank is
the fourth 8 KB bank (file $6000-$7FFF), not the last one, and the image
carries the reset stub and the vector table twice.  The live NMI vector
is $808F - the frame handler - while the copy at the end of the image
names $8189, which is a BRK in the first half.  The game's text table
lives at CPU $F1D6, which is the fixed window, and that is what settles
the question.

Also: the leftover _wip/MAPPER8 folder is removed, as it is for every
other promotion.

The project builds byte identical:

    Byte-identical ROM verified.

Add CHANGELOG.md: the pass history of every project

A project goes through four milestones - Pass 1 (the code/data split),
Pass 2 (the labels replaced by names), Pass 3 (the semantic naming) and
Promotion (the move into the top-level mapper folder) - and the history
of those milestones was scattered over the commit log, the project
READMEs and the root README.

CHANGELOG.md gathers it: one section per project with a row for each
milestone, the date, and a sentence saying what the milestone produced.
The numbers are the ones the project README and the root README already
carry - instruction count, code coverage, named labels, semantic
zero-page aliases, named data tables - so a reader can see at a glance
which projects are done and which are not.  Golf (JU), the only project
still in _wip/ with a real disassembly, is listed with its open
milestones, and the other 852 _wip/ projects are covered as a tier.

The requirement is now part of the workflow contract: PROMPTS.md gains a
"Pass 3: Changelog entry" section and a ninth checklist item, and
AGENTS.md points at the file.  A milestone and its changelog row go in
the same commit, so the changelog and the source never disagree.

Balloon Fight (JU): repair the audit trail and complete the routine headers

The per-instruction audit trail was stale by two bytes from
ResetInitializationData ($C085) onward.  5,944 of the 6,007 comments named
the wrong CPU address and PRG offset, because the three-byte .byte "HAL"
signature at $C082-$C084 had been counted as one byte when the trail was
first generated - the routine headers and the linker labels were right all
along, so the source and its own headers disagreed with each other.  The
trail was rebuilt from the ca65 -l listing with
_tools/repair_audit_comments.py, and every rewritten comment was re-checked
against prg.bin.  The comments were also moved into the canonical column-35
field: they had sat two spaces after the mnemonic, with no column discipline
at all, unlike every other promoted project.

All 63 routine headers now carry a ; Clobbers: block, so the headers carry
the full template AGENTS.md describes.  The blocks are derived, not written by
hand.  The new _tools/derive_clobbers.py takes the opcode from the audit
comment's byte list, so the addressing mode is exact and a data directive is
never mistaken for an instruction; it resolves the operand through
locals.inc and symbols.inc to name what is written; it follows the real
control flow, so a jsr to another named entry is a call (the callee's
clobbers count) while a branch or a fall-through is not; and it models
register preservation, so NmiHandler reports *no register* - it saves and
restores A, X and Y around the frame - and FlushPpuCommandPreserved reports
only A, because X and Y come back unchanged.

Two tools changed.  derive_clobbers.py is new.  align_audit_comments.py had
an off-by-one: it tested the indented code length against 31 instead of
against 35, so code texts of 28-31 characters were never padded into the
column.

The change is comments only.  The code text of all 8,538 lines is unchanged,
make still prints "Byte-identical ROM verified.", the 6,007 audit comments
still re-check against prg.bin, all 63 routine headers agree with the
instructions they describe, and every label agrees with reconstructed.lbl.
ReflectObjectYVelocity and UpdateSpecialObjectSystem moved out of locals.inc
and became labels in prg.s at their real addresses.

CHANGELOG.md becomes the repository's running log: a Pending list of the
changes to be put in the next commit, a History of the commits already made,
and the per-project milestone index at the end.  The next commit's message is
written from the Pending entries, so the two cannot drift apart.  PROMPTS.md
and AGENTS.md describe the new shape.  WIP.md drops the _wip/MAPPER8/ note:
the folder held a copy of Mermaids of Atlantis (U) that had already been
promoted.

World Class Track Meet (U): Pass 1, the code/data split

Pass 1 is done.  The split is 8,400 instructions / 18,028 code bytes (55.0 %)
of the 32 KB PRG, with 884 routine entries, 55 data blocks and 102 zero-page
aliases.  The PRG is CNROM (mapper 3) and maps whole at $8000-$FFFF, so the
linker moved the PRG segment from a .nes file offset to $8000 and the build
still compares byte identical.

Four dispatch tables had to be seeded by hand.  The event table at $F796 (5
entries) is read at $F780 and jumped to through `jmp ($001F)`.  The three
push-pointer tables - $BFC4 (16 entries), $BFE4 (2) and $E5F2 (7) - push a
handler address and `rts` into it, and the 6502's `rts` adds one to the
address it pops, so each table stores the entry address minus one; the seeds
are the table values plus one.  The tracer runs with --undocumented: the code
uses undocumented NMOS opcodes as ordinary code (ANC $37 at $BFF8, and the
RRA/RLA/SLO and NOP forms elsewhere).  Seeding the tables takes the coverage
from 27.8 % to 55.0 %.

$C0BE-$C0C5 is forced back to data: the IRQ vector $C0C0 points into the
middle of the `jmp $C047` at $C0BE, and the game never executes CLI, so the
vector is dead.  `make pass1` regenerates prg.s and locals.inc from prg.bin
and reproduces the committed prg.s byte for byte.

The project README records the split, the four dispatch tables, the dead IRQ
vector, the wrong CHR size field in the header, and what is still data.  The
milestone index in CHANGELOG.md gains the project; WIP.md, README.md and
AGENTS.md follow the tier counts and the layout.

nesdis.py gains a --mapping-note option, so the header's "PRG mapped at" line
can describe a board that is not NROM - CNROM's whole 32 KB at $8000-$FFFF is
not "mirrored to the upper half".

Replaces runs of $00 and $FF with .res <run>, <byte>

Golf (JU) and World Class Track Meet (U): Pass 2/3 complete, promoted from _wip/

- World Class Track Meet (U) - Pass 2 complete: all 884 Label_<addr>
  definitions replaced (651 semantic routine names + 233 Sub_<addr>), all 731
  raw $XXXX jsr/jmp call operands resolved to symbolic labels, all branch
  targets given role-based names; routinemap.tsv added; make stays
  byte-identical.
- World Class Track Meet (U) - Pass 3 complete: 24 semantic zero-page
  aliases applied via apply_symbols.py (0 residue), 78 neutral ZpXX slots
  documented with reasons in locals.inc, all hardware-register operands use
  symbols.inc names, project README rewritten with Pass 2/Pass 3 sections and
  data-table inventory; promoted out of _wip/CNROM/.
- World Class Track Meet (U) - project README documents the five event-table
  entries at $F796 and marks the olympics mode as not yet proven.
- Golf (JU) - audit comments converted from pre-canonical (; C000: A9 00)
  to the canonical ; CPU:$C000 PRG:0000  A9 00 form at column 35; 4,156
  comments re-aligned, comment/whitespace only, whole-ROM build stays
  byte-identical.
- Golf (JU) - 339 internal branch-target Label_ labels given role-based names
  via _tools/derive_branch_names.py; 0 raw $XXXX branch/jump operands remain.
- Golf (JU) - 275 zero-page operands substituted with locals.inc aliases via
  apply_symbols.py; 0 residue; promoted out of _wip/NROM/.
- Xevious (U) - runs of $FF padding replaced with .res <count>, $FF in prg.s;
  whole-ROM build stays byte-identical.
- Both projects promoted via git mv; leftover _wip/ folders removed; root
  README.md inventory rows added; WIP.md rows removed.

World Class Track Meet (U): apply zero-page symbol substitutions

Run apply_symbols.py to substitute ZpXX zero-page operands with
semantic locals.inc aliases (SlotState, GameMode, etc.) at proven
sites; 0 residue, whole-ROM build stays byte-identical.

Xevious (U): re-split Pass 1 from the Mesen CDL and decode the data tables

- Xevious (U) - Pass 1 re-split from the Mesen CDL (xevious_mesen.cdl) with
  _tools/cdl_reclass.py: 1,158 bytes data->code, 48 code->data, 42 labels
  emitted and 3 branch targets labelled; code 11,321->12,455 bytes
  (34.5%->38.0%), instructions 5,513->6,002. The 45 recovered entry points
  are named Sub_XXXX, so no Label_XXXX remains; six CDL-silent raw call
  operands are documented as residue.
- Xevious (U) - the 4,448-byte block at $A74B-$B8AA is split into six proven
  tables: VramWritePtrTable (15 pointers), VramWriteData, DataStreamPtrTable
  (16), ObjTilePtrTable (99), ObjTileData and DataStreamData. The $D833
  pointer table is corrected to base $D833 (4 entries; the old ObjCodePtrTable
  at $D834 was one byte late). $F957-$FAF5 is split into ObjSpeedTable,
  ObjSpeedTable2, SpriteLayoutPtrTable (19) and SpriteLayoutData;
  $FEE6-$FF1C into PaletteData and OamAttrTable. $F5D8 is decoded as
  TextTileData (font tile indices: PLAYER, GAME OVER, READY, SOLVALOU, LEFT,
  PAUSE); $F53C becomes AttrAddrTable, $F89E HandlerPtrTable and $EF3B
  SpriteLayoutData2. Project README rewritten with the corrected stats, a
  32-entry table inventory and the Pass 1 residue.
- _tools/cdl_reclass.py - preserve the data label(s) between a data-block
  header and its first .byte row when the block stays data; the $DF78 split
  dropped Data_DF78 and the rebuild failed with an undefined symbol.
- _tools/resolve_raw_branches.py - handle negative relative offsets
  (beq *-$0B); the pattern only matched *+$NN and *$NN.

Docs: refresh the tier counts to 41 promoted / 851 _wip, add the WCTM row

- Docs - tier counts refreshed to the post-promotion state across AGENTS.md,
  root README.md, WIP.md, TODO.md and CHANGELOG.md: 41 promoted projects
  (38 under NROM/, plus CNROM/World Class Track Meet (U), UNROM/Zanac (U) and
  MAPPER8/Mermaids of Atlantis (U)) and 851 _wip/ projects, every one of them
  a Pass 0 skeleton. The stale "39/40 promoted", "853 _wip", "Golf (JU) is
  still in _wip/" and "Golf is the last pre-canonical project" statements are
  corrected.
- Root README.md - the promoted inventory gained the missing World Class Track
  Meet (U) row (row 41, mapper 3, 32 KB PRG / 32 KB CHR), and the "All 38 are
  mapper 0 / 16 KB PRG" sentence is replaced with the actual split (36 of the
  41 rows are mapper 0 / 16 KB; Xevious and Volleyball are 32 KB, World Class
  Track Meet is mapper 3, Zanac mapper 2 and Mermaids mapper 8).
2026-10-21 11:36:32 -04:00

16 KiB

1FF00Reset
2FF2FSelectChrBanks
3FF3EStartGame
4FF49WritePrgBankReg
5FF4CDelayOuterLoop
6FF50DelayInnerLoop
7FF57WaitForBankSwitch
8FF62StartBankSwitchDelay
9FF70SwitchPrgBank
10FF80SwitchPrgBankKeepA
118004BankedCall
12801BSelectPrgBankByIndex
138036InitializeGame
148038WaitForVBlank
158057ClearRamLoop
168062ClearRamPageDone
17806BInitGameVariables
188083IdleWaitLoop
19808FNmiHandler
2080A6UploadOam
21811CRunGameLogic
2285DDTickAnimationCounter
238606ApplyGraphicsMode
248A5FInitLevelState
258E34CopyStackPage
269621TickLevelTimer
2797ECResetLevelTimers
28813FReadControllers
29814DReadControllerBits
308173DispatchByJumpTable
318188ClearOamShadow
3281B1UpdateNametable
3382E9UpdateSprites
3483C3UpdateActorSprites
35849DStartVramWrite
3684A4WriteVramTiles
3789FCAnimatePalette
3890A9ReadPlayerInput
3991ACBuildOamBuffer
409228ClearSpriteSlots
41962ELoadSpriteTable
42967CSetGraphicsMode
439786UpdateGameState
44981BSetTablePointer
45AEC7ClearBubbleSlots
46BB4FClearActorSlots
47BB5BClearActorTable
48BB68SoundTimerTick
49BB7EPlaySoundEffect
50BB94LoadActorTemplate
51BB9ECopyActorToSpriteTable
52BBFAUpdatePlayerState
53BC1CHandleDemoMode
54BC38HandlePlayerInput
55BC44CountPlayerFrames
56BCF9MovePlayer
57BD26ApplyPlayerDirection
58BD70ComputePlayerPosition
59BDE1StorePlayerSprite
60BEE4BuildBubbleTable
61BF17UpdateBubbles
62BF53PlayBubbleSound
63BF67SpawnBubble
64BF83DrawBubble
65BF9ADispatchBubbleHandler
66BFAFResetLevel
67BFBAClearSpriteTable
68C000ClearNametableRam
69C00FPlayStageMusic
70C2A7DispatchLevelScript
71C2BFResetPpuAndLoadTiles
72C3C8SetVramPointer
73C414ClearSpriteEntry
74C456TickStageDelay
75C505UpdateStageMode
76C62ADisablePpuRendering
77CC11SetPlayerActive
78CC56CheckPlayerActive
79CCCFTickSoundOnEvenFrame
80CD18UpdateSoundEngine
81CF32CheckActorCount
82D0E7TickActorsOnEvenFrame
83D1B0InitPlayerPosition
84D21ATickTimerOnEvenFrame
85D2C0ResetScrollOnEvenFrame
86D507InitBubbleState
87D537UpdateBubbleFrame
88D563TickHudOnEvenFrame
89D5CFTickSpritesOnEvenFrame
90D615SetSoundChannels
91Bank4:800DBank4_CallBankedHandler
92Bank4:80A7Bank4_StartVramWrite
93Bank4:8161Bank4_UpdateNametable
94Bank5:A726Bank5_UpdateSound
95Bank5:A784Bank5_ReadSoundTable
96Bank5:AB50Bank5_SetSoundMode
97Bank7:FF70Bank7_SwitchPrgBank
98# ---- derived internal branch-target names ----
998004BankedCall
100801BSelectPrgBankByIndex
1018025Sub_8025
1028036InitializeGame
1038038WaitForVBlank
1048057ClearRamLoop
1058062ClearRamPageDone
106806BInitGameVariables
1078083IdleWaitLoop
108808FNmiHandler
1098097NmiHandler_Loop
11080A6UploadOam
11180BCUploadOam_Loop
11280C4UploadOam_Loop2
113811CRunGameLogic
114813FReadControllers
115814DReadControllerBits
1168153ReadControllerBits_OnNonzero
1178173DispatchByJumpTable
1188188ClearOamShadow
119818CClearOamShadow_OnNonzero
12081B1UpdateNametable
12181B8UpdateNametable_OnNonzero
12281D7UpdateNametable_OnCarryClear
12381E4UpdateNametable_OnNonzero2
1248204UpdateNametable_Loop
125820FUpdateNametable_Loop2
1268214UpdateNametable_Loop3
1278215UpdateNametable_OnNonzero3
1288270UpdateNametable_Loop4
1298276UpdateNametable_OnNonzero4
130829AUpdateNametable_OnNonzero5
13182A7UpdateNametable_OnNonzero6
13282C8Sub_82C8
13382E9UpdateSprites
13482F7UpdateSprites_Loop
13582F9UpdateSprites_Loop2
13682FBUpdateSprites_OnCarryClear
1378303UpdateSprites_Loop3
138830CSub_830C
1398349UpdateSprites_OnNonzero
1408378UpdateSprites_Loop4
141837BUpdateSprites_Loop5
142838BUpdateSprites_Loop6
143838DSub_838D
144839FUpdateSprites_Loop7
14583A1Sub_83A1
14683C2UpdateSprites_Loop8
14783C3UpdateActorSprites
14883C7UpdateActorSprites_OnCarryClear
14983CFUpdateActorSprites_Loop
150840BUpdateActorSprites_OnNonzero
151840CSub_840C
1528424UpdateActorSprites_Loop2
1538451UpdateActorSprites_Loop3
154848CSub_848C
1558492UpdateActorSprites_OnNonzero2
156849DStartVramWrite
15784A4WriteVramTiles
15884BFSub_84BF
15984D2WriteVramTiles_Loop
16084DBWriteVramTiles_Loop2
16184E3Sub_84E3
1628534WriteVramTiles_Loop3
1638552Sub_8552
164855DSub_855D
165858ASub_858A
16685A7Sub_85A7
16785C4Sub_85C4
16885D2WriteVramTiles_OnCarryClear
16985DDTickAnimationCounter
17085E4TickAnimationCounter_Loop
1718606ApplyGraphicsMode
1728663Sub_8663
1738676ApplyGraphicsMode_OnNonzero
174867DApplyGraphicsMode_OnZero
1758686ApplyGraphicsMode_OnNonzero2
17686D1ApplyGraphicsMode_Loop
17786F0ApplyGraphicsMode_Loop2
1788709ApplyGraphicsMode_Loop3
179872CApplyGraphicsMode_Loop4
1808745ApplyGraphicsMode_OnNonzero3
181874EApplyGraphicsMode_Loop5
18289FCAnimatePalette
1838A35AnimatePalette_Loop
1848A5FInitLevelState
1858A66InitLevelState_Loop
1868A75InitLevelState_OnNonzero
1878A93InitLevelState_OnNonzero2
1888AE1Sub_8AE1
1898B0EInitLevelState_Loop2
1908E34CopyStackPage
1918E36CopyStackPage_OnCarryClear
1929084Sub_9084
19390A9ReadPlayerInput
19490BBReadPlayerInput_Loop
19590C9ReadPlayerInput_Loop2
19690D9ReadPlayerInput_Loop3
19790EAReadPlayerInput_Loop4
19890F6ReadPlayerInput_Loop5
19990FCSub_90FC
20091ACBuildOamBuffer
20191B4BuildOamBuffer_OnCarryClear
20291D7BuildOamBuffer_OnNonzero
20391F0BuildOamBuffer_OnNonzero2
204920DBuildOamBuffer_Loop
205920FBuildOamBuffer_Loop2
2069228ClearSpriteSlots
207922BClearSpriteSlots_OnNonzero
2089621TickLevelTimer
209962DTickLevelTimer_Loop
210962ELoadSpriteTable
2119634LoadSpriteTable_OnCarryClear
212964ELoadSpriteTable_Loop
2139650LoadSpriteTable_OnNonzero
2149671LoadSpriteTable_Loop2
215967CSetGraphicsMode
2169687SetGraphicsMode_Loop
2179692SetGraphicsMode_Loop2
218969CSetGraphicsMode_Loop3
21996A6SetGraphicsMode_Loop4
22096ADSetGraphicsMode_OnCarryClear
22196C8SetGraphicsMode_Loop5
22296D9SetGraphicsMode_Loop6
22396DFSetGraphicsMode_Loop7
22496E3Sub_96E3
2259703Sub_9703
2269706SetGraphicsMode_OnCarryClear2
227970FSub_970F
2289712SetGraphicsMode_OnCarryClear3
2299786UpdateGameState
23097A6UpdateGameState_Loop
23197AEUpdateGameState_Loop2
23297BAUpdateGameState_Loop3
23397C3UpdateGameState_Loop4
23497C8UpdateGameState_Loop5
23597DEUpdateGameState_Loop6
23697DFUpdateGameState_Loop7
23797ECResetLevelTimers
23897F3ResetLevelTimers_Loop
239981AResetLevelTimers_Loop2
240981BSetTablePointer
2419829SetTablePointer_Loop
2429830SetTablePointer_OnCarryClear
2439841SetTablePointer_Loop2
244A78FSub_A78F
245AEC7ClearBubbleSlots
246AECAClearBubbleSlots_OnCarryClear
247BB4FClearActorSlots
248BB52ClearActorSlots_OnCarryClear
249BB5BClearActorTable
250BB68SoundTimerTick
251BB6ESoundTimerTick_Loop
252BB7DSoundTimerTick_Loop2
253BB7EPlaySoundEffect
254BB94LoadActorTemplate
255BB9ECopyActorToSpriteTable
256BBA6CopyActorToSpriteTable_OnNonzero
257BBBACopyActorToSpriteTable_Loop
258BBFAUpdatePlayerState
259BC09UpdatePlayerState_Loop
260BC11Sub_BC11
261BC19UpdatePlayerState_Loop2
262BC1CHandleDemoMode
263BC38HandlePlayerInput
264BC44CountPlayerFrames
265BC56CountPlayerFrames_Loop
266BC5ACountPlayerFrames_Loop2
267BC68CountPlayerFrames_Loop3
268BC84CountPlayerFrames_Loop4
269BC8DCountPlayerFrames_Loop5
270BC98CountPlayerFrames_Loop6
271BCA9CountPlayerFrames_Loop7
272BCB8CountPlayerFrames_Loop8
273BCD6CountPlayerFrames_Loop9
274BCE1CountPlayerFrames_Loop10
275BCF1CountPlayerFrames_Loop11
276BCF9MovePlayer
277BD0BMovePlayer_Loop
278BD21MovePlayer_Loop2
279BD26ApplyPlayerDirection
280BD36ApplyPlayerDirection_Loop
281BD3EApplyPlayerDirection_Loop2
282BD4FApplyPlayerDirection_Loop3
283BD57ApplyPlayerDirection_Loop4
284BD5FApplyPlayerDirection_Loop5
285BD70ComputePlayerPosition
286BD88ComputePlayerPosition_OnNonzero
287BD9FComputePlayerPosition_Loop
288BDADComputePlayerPosition_Loop2
289BDBDComputePlayerPosition_Loop3
290BDCCComputePlayerPosition_OnCarrySet
291BDCFComputePlayerPosition_Loop4
292BDE1StorePlayerSprite
293BDF1StorePlayerSprite_OnNonzero
294BEE4BuildBubbleTable
295BEE8BuildBubbleTable_OnCarryClear
296BF17UpdateBubbles
297BF21UpdateBubbles_OnCarryClear
298BF29UpdateBubbles_OnNonnegative
299BF49UpdateBubbles_Loop
300BF53PlayBubbleSound
301BF59PlayBubbleSound_Loop
302BF67SpawnBubble
303BF73SpawnBubble_Loop
304BF83DrawBubble
305BF9ADispatchBubbleHandler
306BFAFResetLevel
307BFBAClearSpriteTable
308BFDCClearSpriteTable_Loop
309BFE6ClearSpriteTable_OnCarryClear
310C000ClearNametableRam
311C006ClearNametableRam_OnCarryClear
312C00EClearNametableRam_Loop
313C00FPlayStageMusic
314C015PlayStageMusic_Loop
315C019PlayStageMusic_OnCarryClear
316C035PlayStageMusic_Loop2
317C061Sub_C061
318C064PlayStageMusic_OnCarryClear2
319C0F2Sub_C0F2
320C100PlayStageMusic_OnCarryClear3
321C10EPlayStageMusic_Loop3
322C136PlayStageMusic_Loop4
323C140Sub_C140
324C16EPlayStageMusic_Loop5
325C2A7DispatchLevelScript
326C2BFResetPpuAndLoadTiles
327C308ResetPpuAndLoadTiles_OnNonzero
328C319ResetPpuAndLoadTiles_OnNonzero2
329C32BResetPpuAndLoadTiles_Loop
330C33EResetPpuAndLoadTiles_Loop2
331C357ResetPpuAndLoadTiles_OnCarryClear
332C366ResetPpuAndLoadTiles_OnNonzero3
333C37DResetPpuAndLoadTiles_Loop3
334C3A5ResetPpuAndLoadTiles_Loop4
335C3B7ResetPpuAndLoadTiles_Loop5
336C3C3ResetPpuAndLoadTiles_Loop6
337C3C8SetVramPointer
338C3E2SetVramPointer_Loop
339C40ASetVramPointer_Loop2
340C414ClearSpriteEntry
341C456TickStageDelay
342C460TickStageDelay_Loop
343C468TickStageDelay_Loop2
344C505UpdateStageMode
345C513UpdateStageMode_Loop
346C519UpdateStageMode_OnNonzero
347C531UpdateStageMode_Loop2
348C544UpdateStageMode_Loop3
349C54AUpdateStageMode_OnCarryClear
350C556UpdateStageMode_Loop4
351C55BUpdateStageMode_Loop5
352C59EUpdateStageMode_Loop6
353C59FUpdateStageMode_Loop7
354C5D2Sub_C5D2
355C62ADisablePpuRendering
356C671DisablePpuRendering_Loop
357C68BDisablePpuRendering_OnCarryClear
358C694DisablePpuRendering_Loop2
359C6B7Sub_C6B7
360C6BADisablePpuRendering_OnCarryClear2
361C6C3DisablePpuRendering_OnCarryClear3
362C7EASub_C7EA
363C7FFDisablePpuRendering_Loop3
364C800DisablePpuRendering_Loop4
365C80DDisablePpuRendering_Loop5
366C81DDisablePpuRendering_Loop6
367C839DisablePpuRendering_Loop7
368C83ASub_C83A
369C840DisablePpuRendering_Loop8
370CBC4Sub_CBC4
371CBD9DisablePpuRendering_Loop9
372CBE8DisablePpuRendering_Loop10
373CBF8DisablePpuRendering_Loop11
374CC11SetPlayerActive
375CC1DSetPlayerActive_Loop
376CC48SetPlayerActive_Loop2
377CC56CheckPlayerActive
378CC68CheckPlayerActive_Loop
379CC86CheckPlayerActive_Loop2
380CC8BCheckPlayerActive_Loop3
381CC93CheckPlayerActive_Loop4
382CCBCCheckPlayerActive_Loop5
383CCBDCheckPlayerActive_Loop6
384CCCFTickSoundOnEvenFrame
385CCD5TickSoundOnEvenFrame_Loop
386CCDCTickSoundOnEvenFrame_Loop2
387CD02TickSoundOnEvenFrame_Loop3
388CD18UpdateSoundEngine
389CD1CSub_CD1C
390CD27UpdateSoundEngine_OnNonzero
391CD52UpdateSoundEngine_Loop
392CD59Sub_CD59
393CD6DUpdateSoundEngine_Loop2
394CD7EUpdateSoundEngine_Loop3
395CDA0UpdateSoundEngine_OnCarryClear
396CDB6Sub_CDB6
397CDC8UpdateSoundEngine_OnCarryClear2
398CDE2UpdateSoundEngine_OnCarryClear3
399CDF0Sub_CDF0
400CE01UpdateSoundEngine_OnCarryClear4
401CE0DSub_CE0D
402CE13UpdateSoundEngine_Loop4
403CE30UpdateSoundEngine_OnNonzero2
404CE42UpdateSoundEngine_Loop5
405CE51UpdateSoundEngine_OnCarryClear5
406CE8BSub_CE8B
407CE91UpdateSoundEngine_Loop6
408CE9AUpdateSoundEngine_OnNonzero3
409CEE0UpdateSoundEngine_OnCarryClear6
410CF32CheckActorCount
411CF4DCheckActorCount_Loop
412CF4FCheckActorCount_OnCarryClear
413CF5DCheckActorCount_Loop2
414CF89CheckActorCount_Loop3
415CF8FSub_CF8F
416CF9BCheckActorCount_Loop4
417CF9CCheckActorCount_Loop5
418CFFDSub_CFFD
419D001CheckActorCount_OnCarryClear2
420D00ECheckActorCount_Loop6
421D015CheckActorCount_Loop7
422D022CheckActorCount_OnNonzero
423D042CheckActorCount_Loop8
424D046Sub_D046
425D04ECheckActorCount_OnNonzero2
426D05BCheckActorCount_Loop9
427D07ECheckActorCount_Loop10
428D084CheckActorCount_Loop11
429D08DCheckActorCount_Loop12
430D0A5CheckActorCount_Loop13
431D0B3CheckActorCount_Loop14
432D0D1CheckActorCount_OnNonnegative
433D0E2CheckActorCount_Loop15
434D0E7TickActorsOnEvenFrame
435D0EDTickActorsOnEvenFrame_Loop
436D106TickActorsOnEvenFrame_Loop2
437D110TickActorsOnEvenFrame_Loop3
438D112TickActorsOnEvenFrame_OnCarryClear
439D122TickActorsOnEvenFrame_Loop4
440D12CTickActorsOnEvenFrame_OnNonzero
441D15BTickActorsOnEvenFrame_Loop5
442D15FSub_D15F
443D16DTickActorsOnEvenFrame_OnNonnegative
444D181Sub_D181
445D183TickActorsOnEvenFrame_OnNonnegative2
446D1B0InitPlayerPosition
447D1B8InitPlayerPosition_OnCarryClear
448D1C3InitPlayerPosition_OnNonzero
449D1D1InitPlayerPosition_OnNonzero2
450D1E6InitPlayerPosition_Loop
451D1F8InitPlayerPosition_Loop2
452D204InitPlayerPosition_Loop3
453D219InitPlayerPosition_Loop4
454D21ATickTimerOnEvenFrame
455D220TickTimerOnEvenFrame_Loop
456D22ATickTimerOnEvenFrame_OnCarryClear
457D22FTickTimerOnEvenFrame_OnCarrySet
458D241TickTimerOnEvenFrame_Loop2
459D24BTickTimerOnEvenFrame_OnZero
460D27FTickTimerOnEvenFrame_Loop3
461D28ATickTimerOnEvenFrame_Loop4
462D294TickTimerOnEvenFrame_Loop5
463D2ABTickTimerOnEvenFrame_Loop6
464D2AFTickTimerOnEvenFrame_Loop7
465D2C0ResetScrollOnEvenFrame
466D2C6ResetScrollOnEvenFrame_Loop
467D2CDResetScrollOnEvenFrame_OnNonnegative
468D2DCResetScrollOnEvenFrame_Loop2
469D2E9ResetScrollOnEvenFrame_OnNonzero
470D2FBResetScrollOnEvenFrame_Loop3
471D327ResetScrollOnEvenFrame_OnNonzero2
472D339ResetScrollOnEvenFrame_Loop4
473D33EResetScrollOnEvenFrame_OnNonnegative2
474D34DResetScrollOnEvenFrame_OnNonzero3
475D35FResetScrollOnEvenFrame_Loop5
476D374ResetScrollOnEvenFrame_OnCarryClear
477D399ResetScrollOnEvenFrame_OnCarryClear2
478D45ESub_D45E
479D464ResetScrollOnEvenFrame_OnNonnegative3
480D470ResetScrollOnEvenFrame_Loop6
481D485ResetScrollOnEvenFrame_Loop7
482D4EESub_D4EE
483D507InitBubbleState
484D50FInitBubbleState_OnNonzero
485D52BInitBubbleState_Loop
486D52CInitBubbleState_Loop2
487D537UpdateBubbleFrame
488D559UpdateBubbleFrame_Loop
489D55AUpdateBubbleFrame_Loop2
490D560UpdateBubbleFrame_Loop3
491D563TickHudOnEvenFrame
492D569TickHudOnEvenFrame_Loop
493D595Sub_D595
494D59BTickHudOnEvenFrame_OnNonzero
495D5A5TickHudOnEvenFrame_Loop2
496D5AFSub_D5AF
497D5B3TickHudOnEvenFrame_OnNonzero2
498D5B4TickHudOnEvenFrame_OnNonnegative
499D5C0TickHudOnEvenFrame_Loop3
500D5C6TickHudOnEvenFrame_Loop4
501D5CFTickSpritesOnEvenFrame
502D5D5TickSpritesOnEvenFrame_Loop
503D5E3TickSpritesOnEvenFrame_OnNonnegative
504D5EFTickSpritesOnEvenFrame_Loop2
505D609TickSpritesOnEvenFrame_Loop3
506D60DTickSpritesOnEvenFrame_Loop4
507D615SetSoundChannels
508FF00Reset
509FF2FSelectChrBanks
510FF3EStartGame
511FF49WritePrgBankReg
512FF4CDelayOuterLoop
513FF4EDelayOuterLoop_OnNonzero
514FF50DelayInnerLoop
515FF57WaitForBankSwitch
516FF60WaitForBankSwitch_Loop
517FF62StartBankSwitchDelay
518FF70SwitchPrgBank
519FF80SwitchPrgBankKeepA
520Bank4:800DBank4_CallBankedHandler
521Bank4:801BBank4_Sub_801B
522Bank4:8088Bank4_Sub_8088
523Bank4:80A7Bank4_StartVramWrite
524Bank4:80C9Bank4_Sub_80C9
525Bank4:80E3Bank4_Bank4_StartVramWrite_OnZero
526Bank4:80F2Bank4_Bank4_StartVramWrite_OnNonzero
527Bank4:8100Bank4_Bank4_StartVramWrite_Loop
528Bank4:8107Bank4_Bank4_StartVramWrite_OnNonzero2
529Bank4:8110Bank4_Bank4_StartVramWrite_Loop2
530Bank4:8111Bank4_Sub_8111
531Bank4:8117Bank4_Bank4_StartVramWrite_Loop3
532Bank4:8118Bank4_Sub_8118
533Bank4:8126Bank4_Bank4_StartVramWrite_OnCarryClear
534Bank4:8161Bank4_UpdateNametable
535Bank4:8167Bank4_Bank4_UpdateNametable_OnZero
536Bank4:817ABank4_Bank4_UpdateNametable_OnNonzero
537Bank4:8186Bank4_Bank4_UpdateNametable_Loop
538Bank5:A71ABank5_Sub_OnZero
539Bank5:A726Bank5_UpdateSound
540Bank5:A75BBank5_Sub_A75B
541Bank5:A768Bank5_Bank5_UpdateSound_OnNonnegative
542Bank5:A784Bank5_ReadSoundTable
543Bank5:A7FBBank5_Bank5_ReadSoundTable_Loop
544Bank5:A7FFBank5_Sub_A7FF
545Bank5:A817Bank5_Bank5_ReadSoundTable_Loop2
546Bank5:A827Bank5_Bank5_ReadSoundTable_Loop3
547Bank5:A828Bank5_Bank5_ReadSoundTable_Loop4
548Bank5:A830Bank5_Bank5_ReadSoundTable_OnZero
549Bank5:A831Bank5_Bank5_ReadSoundTable_Loop5
550Bank5:A839Bank5_Bank5_ReadSoundTable_Loop6
551Bank5:A83CBank5_Bank5_ReadSoundTable_Loop7
552Bank5:A858Bank5_Bank5_ReadSoundTable_Loop8
553Bank5:A871Bank5_Bank5_ReadSoundTable_Loop9
554Bank5:A87BBank5_Bank5_ReadSoundTable_Loop10
555Bank5:A887Bank5_Bank5_ReadSoundTable_OnCarryClear
556Bank5:A892Bank5_Bank5_ReadSoundTable_Loop11
557Bank5:A8A8Bank5_Bank5_ReadSoundTable_Loop12
558Bank5:A8AFBank5_Bank5_ReadSoundTable_Loop13
559Bank5:A8C7Bank5_Bank5_ReadSoundTable_Loop14
560Bank5:A8CFBank5_Bank5_ReadSoundTable_Loop15
561Bank5:A8D5Bank5_Bank5_ReadSoundTable_Loop16
562Bank5:A8DCBank5_Bank5_ReadSoundTable_Loop17
563Bank5:A8E8Bank5_Bank5_ReadSoundTable_OnNonzero
564Bank5:A8F1Bank5_Bank5_ReadSoundTable_Loop18
565Bank5:A913Bank5_Bank5_ReadSoundTable_OnZero2
566Bank5:A92BBank5_Bank5_ReadSoundTable_Loop19
567Bank5:A932Bank5_Bank5_ReadSoundTable_Loop20
568Bank5:A93EBank5_Bank5_ReadSoundTable_Loop21
569Bank5:A954Bank5_Bank5_ReadSoundTable_Loop22
570Bank5:A976Bank5_Bank5_ReadSoundTable_Loop23
571Bank5:A989Bank5_Bank5_ReadSoundTable_Loop24
572Bank5:A99CBank5_Bank5_ReadSoundTable_Loop25
573Bank5:A9A9Bank5_Bank5_ReadSoundTable_Loop26
574Bank5:A9B6Bank5_Bank5_ReadSoundTable_Loop27
575Bank5:A9C3Bank5_Sub_A9C3
576Bank5:A9D5Bank5_Bank5_ReadSoundTable_Loop28
577Bank5:A9E9Bank5_Sub_A9E9
578Bank5:AA05Bank5_Bank5_ReadSoundTable_Loop29
579Bank5:AA15Bank5_Bank5_ReadSoundTable_Loop30
580Bank5:AA4DBank5_Bank5_ReadSoundTable_Loop31
581Bank5:AA53Bank5_Bank5_ReadSoundTable_OnZero3
582Bank5:AA54Bank5_Bank5_ReadSoundTable_OnZero4
583Bank5:AA66Bank5_Bank5_ReadSoundTable_Loop32
584Bank5:AA7ABank5_Sub_AA7A
585Bank5:AA81Bank5_Bank5_ReadSoundTable_OnNonzero2
586Bank5:AA8EBank5_Bank5_ReadSoundTable_OnNonzero3
587Bank5:AAF1Bank5_Sub_AAF1
588Bank5:AB11Bank5_Sub_AB11
589Bank5:AB27Bank5_Bank5_ReadSoundTable_OnNonzero4
590Bank5:AB43Bank5_Bank5_ReadSoundTable_Loop33
591Bank5:AB46Bank5_Bank5_ReadSoundTable_Loop34
592Bank5:AB50Bank5_SetSoundMode
593Bank7:FF70Bank7_SwitchPrgBank