alttp-disasm-labels

Map ALTTP ROM addresses to labels using USDASM and JPDisasm sources.

Updated Dec 30, 2025

Search Tags:#symbols #labels #lookup #disassembly #alttp #usdasm #jpdasm

Ready to run

npx skills add https://github.com/scawful/afs_scawful --skill alttp-disasm-labels

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: alttp-disasm-labels
Source: https://github.com/scawful/afs_scawful/tree/main/skills/alttp-disasm-labels
Command: npx skills add https://github.com/scawful/afs_scawful --skill alttp-disasm-labels

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

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

Core Features & Use Cases

Symbol -> code context: Hyrule Historian lookup, then search raw disassembly in usdasm/jpdasm for corresponding labels, improving traceability.
Address -> symbol mapping: Cross-reference ROM addresses to function labels using label indexes and disassembly roots to resolve runtime events.
Use Case: When debugging a crash log mentioning a ROM address, quickly locate the associated routine and data.

Quick Start

Query Hyrule Historian for a symbol, then confirm its presence in usdasm/jpdasm to map a ROM address to a label.

Frequently Asked Questions about alttp-disasm-labels

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I map ALTTP ROM addresses to function labels in a disassembly?▼

To map ALTTP ROM addresses to function labels, cross-reference the addresses against label indexes and disassembly roots from USDASM or JPDisasm sources to resolve runtime events into routines.

How do I find ALTTP disassembly labels when debugging a crash log?▼

Find ALTTP disassembly labels for crash logs by querying Hyrule Historian for a symbol, then searching the raw USDASM or JPDisasm output to map the ROM address to its associated routine and data.

Do I need USDASM and JPDisasm sources to look up ALTTP symbols?▼

Yes, resolving ALTTP symbols requires access to USDASM and JPDisasm sources, local label indexes, and frontmatter-driven guidance to correctly resolve context and refresh indexes as needed.

What is the best way to trace a runtime event to an ALTTP ROM routine?▼

The best way to trace a runtime event to an ALTTP ROM routine is using address-to-symbol mapping via label reference files and disassembly roots, which links runtime traces directly to the correct routines and data.

Can I use z3dk label indexes to resolve ALTTP bug reports?▼

Yes, you can resolve ALTTP bug reports by applying z3dk label indexes and disassembly sources to map the mentioned ROM addresses to the correct routines and data for improved traceability.