{"id":13829842,"url":"https://github.com/zladx/LADX-Disassembly","last_synced_at":"2025-07-09T10:31:53.014Z","repository":{"id":36208055,"uuid":"40512314","full_name":"zladx/LADX-Disassembly","owner":"zladx","description":"Disassembly of Legend of Zelda: Links Awakening DX","archived":false,"fork":false,"pushed_at":"2024-02-26T16:55:00.000Z","size":45212,"stargazers_count":817,"open_issues_count":20,"forks_count":73,"subscribers_count":32,"default_branch":"main","last_synced_at":"2024-05-21T13:44:37.184Z","etag":null,"topics":["gameboy","hacktoberfest","reverse-engineering","z80"],"latest_commit_sha":null,"homepage":"","language":"Assembly","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zladx.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2015-08-11T00:13:15.000Z","updated_at":"2024-05-12T20:09:44.000Z","dependencies_parsed_at":"2023-01-16T23:46:09.034Z","dependency_job_id":"82df6e03-9bea-4dad-8934-bd2c010cb37e","html_url":"https://github.com/zladx/LADX-Disassembly","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zladx%2FLADX-Disassembly","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zladx%2FLADX-Disassembly/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zladx%2FLADX-Disassembly/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zladx%2FLADX-Disassembly/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zladx","download_url":"https://codeload.github.com/zladx/LADX-Disassembly/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225533024,"owners_count":17484181,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["gameboy","hacktoberfest","reverse-engineering","z80"],"created_at":"2024-08-04T10:00:47.449Z","updated_at":"2025-07-09T10:31:52.988Z","avatar_url":"https://github.com/zladx.png","language":"Assembly","funding_links":[],"categories":["Assembly"],"sub_categories":[],"readme":"# Links Awakening DX Disassembly\n\nDisassembly of one of my favorite games. Taking it easy for now.\n\nIt builds the following ROMs:\n\n- azlj.gbc (Japanese, v1.0) `\nmd5: f75874e3654360094fc2b09bd1fed7e8`\n- azlj-r1.gbc (Japanese, v1.1) `\nmd5: 6d8f9cd72201caabdfd0455a819af9ce`\n- azlj-r2.gbc (Japanese, v1.2) `\nmd5: 2e2596c008d47df901394d28f5bd66ec`\n- azle.gbc (English, v1.0) `\nmd5: 07c211479386825042efb4ad31bb525f`\n- azle-r1.gbc (English, v1.1) `\nmd5: ccbb56212e3dbaa9007d389a17e9d075`\n- azle-r2.gbc (English, v1.2) `\nmd5: 7351daa3c0a91d8f6fe2fbcca6182478`\n- azlg.gbc (German, v1.0) `\nmd5: e91fd46e7092d32ca264f21853f09539`\n- azlg-r1.gbc (German, v1.1) `\nmd5: b0080c2f1919a4bb0ea73b788f4a6786`\n- azlf.gbc (French, v1.0) `\nmd5: 1043fd167d0ed9c4094e3c9d8e757f1e`\n- azlf-r1.gbc (French, v1.1) `\nmd5: 68242187b65166b5f8225b20e2021659`\n\nAdditionally, a wiki includes a [high-level overview of the game engine](https://github.com/zladx/LADX-Disassembly/wiki/Game-engine-documentation), and technical informations on the [data formats used](https://github.com/zladx/LADX-Disassembly/wiki/Maps-data-format) throughout the game.\n\n## Usage\n\n1. Install Python 3 and [rgbds](https://github.com/gbdev/rgbds#1-installing-rgbds) (version \u003e= 0.9.3 required);\n2. `make all`.\n\nThis will build both the games and their debug symbols. Once built, use [BGB](https://github.com/zladx/LADX-Disassembly/wiki/Tooling-for-reverse-engineering#bgb) to load the debug symbols into the debugger.\n\n## How to contribute\n\n1. Fork this repository;\n2. Find a little piece of code to improve:\n  - Maybe a typo, a missing constant, an obvious label that could be renamed;\n  - Or start following a thread (Link's animations? The island fade-out special effect? Trading items constants?) and document some details along your read;\n  - You can also look at the [known improvements](https://github.com/zladx/LADX-Disassembly/issues) – especially [good first issues](https://github.com/zladx/LADX-Disassembly/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22good+first+issue%22);\n3. Submit a pull request.\n\nHaving questions, or do you need help? Join the discussion on [Discord](https://discord.gg/sSHrwdB).\nYou can also read [disassembling How-Tos](https://github.com/zladx/LADX-Disassembly/wiki) in the Wiki, for some infos about the tools and disassembling processes.\n\n## Resources\n\n- [Artemis251's Link's Awakening Cache](http://artemis251.fobby.net/zelda/index.php): ROM map, maps data format\n- [Xkeeper's Link's Awakening depot](https://xkeeper.net/hacking/linksawakening/): maps tilesets and save format infos\n- [LALE](https://github.com/anotak/LALE): level editor, notes on maps data format\n- [The Legend of Zelda Link's Awakening /DX Speedrunning Wiki](http://spiraster.x10host.com/LADXWiki/index.php/) : infos on wrong warps and map data format\n- [Zelda III Disassembly](http://www.zeldix.net/t143-disassembly-zelda-docs) ([archive](https://web.archive.org/web/20180315181518/http://www.zeldix.net/t143-disassembly-zelda-docs)): good source on Zelda SNES source code, which has many similarities to LADX\n- [Disassembling Link's Awakening](https://zladx.github.io): a series of blog posts and progress reports\n- Discord: [LADX](https://discord.gg/sSHrwdB)\n\n## Contributors\n\nThanks to these people for contributing:\n\n* mojobojo - https://github.com/mojobojo\n* kemenaran - https://github.com/kemenaran\n* Drenn1 - https://github.com/Drenn1\n* Sanqui - https://github.com/Sanqui\n* Kyle McGuffin - https://github.com/kcmcg\n* Marijn van der Werf - https://github.com/marijnvdwerf\n* samuel-flynn - https://github.com/samuel-flynn\n* Xkeeper - https://github.com/Xkeeper0\n* Vextrove - https://github.com/Vextrove\n* daid - https://github.com/daid\n* stephaneseng - https://github.com/stephaneseng\n* zelosos - https://gitlab.com/zelosos\n* tobiasvl - https://github.com/tobiasvl\n\n([See contribution details here](https://github.com/zladx/LADX-Disassembly/graphs/contributors))\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzladx%2FLADX-Disassembly","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fzladx%2FLADX-Disassembly","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fzladx%2FLADX-Disassembly/lists"}