endergebnis/Legend-of-Zelda--The--A-Link-to-the-Past

0 Fork 0

Files

T

endergebnis-agent 62c92e2b45 Generate ALttP (USA) port from ROM via snesrecomp

- Recompiled LoROM 1MB USA dump (crc32=777aac2f) with snesrecomp v2 (ef0b3ff7)
- 4 analysis roots emitted to src/gen (bank00 + dispatch/module/stubs)
- ALttP title adapter hooks left in src/game_rtl.c for integration

2026-10-30 11:38:29 +00:00

bank00.cfg

Generate ALttP (USA) port from ROM via snesrecomp

2026-10-30 11:38:29 +00:00

README.md

Initial LegendOfZeldaALinkToThePastSNESRecomp scaffold

2026-10-30 11:35:37 +00:00

symbols.toml

Initial LegendOfZeldaALinkToThePastSNESRecomp scaffold

2026-10-30 11:35:37 +00:00

README.md

recomp/

Analysis input for Legend of Zelda: A Link to the Past. tools/regen.sh reads this directory and writes src/gen/.

File	Owner	Notes
`bank*.cfg`	you, plus generated blocks	Per-bank analysis directives
`symbols.toml`	you	Progressive name map; the source of truth
`funcs.h`	generated	Re-synced by `tools/regen.sh` — do not hand-edit

The block between >>> BEGIN symbols.toml and <<< END symbols.toml in each bank cfg is rewritten from symbols.toml on every regen. Edit symbols.toml, not the block.

Python 3.11+ includes the TOML reader. On older Python, install it with python -m pip install tomli. Projects without symbols.toml do not need it.

Each [[func]] has a C identifier name, a 16-bit hexadecimal addr (for example, "8000"), and an integer bank (for example, 0xc0). Missing bank configs are created automatically; hand-written directives outside the generated blocks are preserved. Removing an entry also removes its generated directives on the next regen.

emit = false (the default) writes a symbol label and force_lle boundary: it stays interpreted, with no generated func declaration in funcs.h.
emit = true writes a func declaration and requests analysis from that entry, even without --cfg-roots. Only variants the analyzer proves safe become AOT code; others still use the interpreter. Optional entry_m and entry_x select the initial register-width flags (0 or 1, both default to 1).

An unchanged cfg file is not by itself evidence of failed code generation: src/gen/bank*_v2.c contains code discovered from the ROM, while bank*.cfg contains analysis inputs. Discovery does not copy every reached function back into the configs.