Skip to content
LiveNew tools this week
Submit
AIMarketly
alttp-disasm-labels logo

ALTTP Disassembly Labels

alttp-disasm-labels

Read and interpret the Link to the Past (ALTTP) disassembly with label/symbol context. Use when mapping ROM/CPU addresses to labels, searching usdasm/jpdasm sources, or cross-referencing routines with Hyrule Historian, z3dk label indexes, or z3ed output.

scawful/afs_scawful0installs0stars

SKILL.md

Full skill instructions

ALTTP Disassembly Labels

Overview

Resolve addresses and symbols across ALTTP disassembly sources (usdasm/​jpdasm) so runtime traces and bug reports map to the correct routines and data.

Quick start

  1. Query Hyrule Historian first for symbols or addresses:
    • mcp__hyrule-historian__lookup("Link_Main")
    • mcp__hyrule-historian__lookup("$07A123")
  2. Search raw disassembly when you need file context:
    • rg -n "Link_Main" ~/​src/​hobby/​alttp-gigaleak/​DISASM/​usdasm
  3. If labels look stale or missing, refresh the z3dk label indexes (see references) or run:
    • python3 ~/​src/​hobby/​oracle-of-secrets/​scripts/​mesen2_client.py labels-refresh

Decision guide

  • Symbol -> code context: Hyrule Historian lookup, then rg in usdasm.
  • Address -> symbol: Hyrule Historian lookup; fallback to the label index CSV.
  • Behavior -> candidate routines: Hyrule Historian search, then scan the relevant bank file.

Working rules

  • Prefer US usdasm for address parity with tooling; use JP jpdasm when US exports are missing.
  • Keep label indexes and disassembly roots aligned before drawing conclusions.

Knowledge References

Use these for structured context beyond raw disassembly:

  • Bank-by-bank reference: ~/​.context/​knowledge/​hobby/​usdasm.md
  • Game architecture (modules, NMI, state machines): ~/​.context/​knowledge/​alttp/​architecture.md
  • Key routines by domain: ~/​.context/​knowledge/​alttp/​routine_index.md
  • ROM data table locations: ~/​.context/​knowledge/​alttp/​data_tables.md
  • Vanilla sprite catalog (243 types): ~/​.context/​knowledge/​alttp/​sprite_catalog.md
  • SNES CPU & memory map: ~/​.context/​knowledge/​snes/​cpu_memory.md

References

  • references/​paths-and-sources.md
  • references/​label-indexes.md
  • references/​lookup-patterns.md