LADX-Disassembly/README.md

Links Awakening DX Disassembly

Disassembly of one of my favorite games. Taking it easy for now.

It builds the following ROMs:

• azlj.gbc (Japanese, v1.0) md5: f75874e3654360094fc2b09bd1fed7e8
• azlj-r1.gbc (Japanese, v1.1) md5: 6d8f9cd72201caabdfd0455a819af9ce
• azlj-r2.gbc (Japanese, v1.2) md5: 2e2596c008d47df901394d28f5bd66ec
• azle.gbc (English, v1.0) md5: 07c211479386825042efb4ad31bb525f
• azle-r1.gbc (English, v1.1) md5: ccbb56212e3dbaa9007d389a17e9d075
• azle-r2.gbc (English, v1.2) md5: 7351daa3c0a91d8f6fe2fbcca6182478
• azlg.gbc (German, v1.0) md5: e91fd46e7092d32ca264f21853f09539
• azlg-r1.gbc (German, v1.1) md5: b0080c2f1919a4bb0ea73b788f4a6786
• azlf.gbc (French, v1.0) md5: 1043fd167d0ed9c4094e3c9d8e757f1e
• azlf-r1.gbc (French, v1.1) md5: 68242187b65166b5f8225b20e2021659

Usage

1. Install Python 3 and rgbds (version >= 0.4.0 required);
2. make all.

This will build both the games and their debug symbols. Use BGB to load the debug symbols into the debugger.

How to contribute

1. Fork this repository;
2. Find a little piece of code to improve:

• Maybe a typo, a missing constant, an obvious label that could be renamed;
• Or start following a thread (Link's animations? The island fade-out special effect? Trading items constants?) and document some details along your read;
• You can also look at the known improvements – especially good first issues;

3. Submit a pull request.

Having questions, or do you need help? Join the discussion on Discord. You can also read disassembling How-Tos in the Wiki, for some infos about the tools and disassembling processes.

Resources

• Artemis251's Link's Awakening Cache: ROM map, maps data format
• Xkeeper's Link's Awakening depot: maps tilesets and save format infos
• LALE: level editor, notes on maps data format
• The Legend of Zelda Link's Awakening /DX Speedrunning Wiki : infos on wrong warps and map data format
• Zelda III Disassembly (archive): good source on Zelda SNES source code, which has many similarities to LADX
• Disassembling Link's Awakening: a series of blog posts and progress reports
• Discord: LADX

Contributors

Thanks to these people for contributing:
(ordered by commits)

• kemenaran - https://github.com/kemenaran
• Marijn van der Werf - https://github.com/marijnvdwerf
• Xkeeper - https://github.com/Xkeeper0
• zelosos - https://gitlab.com/zelosos
• Vextrove - https://github.com/Vextrove
• mojobojo - https://github.com/mojobojo
• Kyle McGuffin - https://github.com/kcmcg
• daid - https://github.com/daid
• Sanqui - https://github.com/Sanqui
• Drenn1 - https://github.com/Drenn1
• stephaneseng - https://github.com/stephaneseng
• samuel-flynn - https://github.com/samuel-flynn

You want to rank up? Then contribute more ;)