Link's Awakening DX
A complete disassembly of The Legend of Zelda: Link's Awakening DX for the Game Boy Color, enabling ROM analysis and modification.
What is Link's Awakening DX?
LADX-Disassembly is a reverse engineering project that provides the complete source code disassembly of The Legend of Zelda: Link's Awakening DX for the Game Boy Color. It enables rebuilding the game's ROMs from source, allowing for deep analysis of game mechanics, data formats, and engine behavior. The project serves as a foundational resource for modders, researchers, and enthusiasts interested in the inner workings of this classic title.
Reverse engineers, ROM hackers, and game preservation enthusiasts focused on classic Game Boy Color games, particularly those interested in Zelda series internals or learning assembly through practical projects.
It offers a fully documented, community-maintained disassembly with multi-version support and extensive external resources, making it the most comprehensive open-source reference for Link's Awakening DX. Unlike opaque binaries, it provides transparency and modifiability for educational and creative purposes.
Overview
Disassembly of Legend of Zelda: Links Awakening DX
Use Cases
Best For
- Studying Game Boy Color game engine architecture and assembly programming
- Creating ROM hacks or mods for Link's Awakening DX
- Learning reverse engineering techniques on a well-documented classic game
- Analyzing Zelda series game design and data structures
- Preserving and documenting vintage video game source code
- Debugging and understanding game behavior with generated debug symbols
Not Ideal For
- Casual users wanting pre-compiled ROMs for immediate play without any setup
- Developers working on modern game engines or projects requiring high-level programming APIs
- Teams focused on other Zelda titles or gaming platforms beyond Game Boy Color emulation
Pros & Cons
Pros
Supports building multiple regional and revision-specific ROMs (e.g., Japanese v1.0, English v1.2) with provided MD5 checksums, ensuring accurate reconstructions for hacking and analysis.
Includes a wiki with high-level game engine overviews and technical details on data formats like maps, directly referenced in the README, aiding deep reverse engineering.
Generates debug symbols for use with emulators like BGB, enabling step-by-step debugging and code inspection as outlined in the usage instructions.
Fosters contributions through labeled issues, a Discord server, and how-to guides, creating a collaborative environment for preservation and hacking.
Cons
Requires installing Python 3 and rgbds (version >= 1.0.0), which can be challenging for users unfamiliar with command-line tools or Game Boy development environments.
Exclusively focuses on Link's Awakening DX; does not extend to other games or provide general-purpose development utilities, reducing its broader applicability.
Relies on a mix of wiki pages and external resources (e.g., Artemis251's cache, speedrunning wiki), which may be incomplete or require cross-referencing, complicating onboarding.
Frequently Asked Questions
Related Projects
pokeredDisassembly of Pokémon Red/Blue
pokecrystalDisassembly of Pokémon Crystal
Pokémon YellowDisassembly of Pokemon Yellow
Pokémon Gold and SilverDisassembly of Pokémon Gold/Silver
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.