{"id":21902492,"url":"https://github.com/leoetlino/botw-re-notes","last_synced_at":"2025-04-15T20:13:48.011Z","repository":{"id":43921267,"uuid":"131200676","full_name":"leoetlino/botw-re-notes","owner":"leoetlino","description":"Reverse engineering notes and tools for The Legend of Zelda: Breath of the Wild","archived":false,"fork":false,"pushed_at":"2019-09-21T16:25:43.000Z","size":111922,"stargazers_count":108,"open_issues_count":0,"forks_count":9,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-15T20:13:34.129Z","etag":null,"topics":["botw","breath-of-the-wild","ida-pro","nintendo-switch","reverse-engineering","zelda"],"latest_commit_sha":null,"homepage":"","language":"C","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/leoetlino.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}},"created_at":"2018-04-26T19:20:12.000Z","updated_at":"2025-02-16T22:45:45.000Z","dependencies_parsed_at":"2022-08-24T07:21:15.553Z","dependency_job_id":null,"html_url":"https://github.com/leoetlino/botw-re-notes","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leoetlino%2Fbotw-re-notes","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leoetlino%2Fbotw-re-notes/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leoetlino%2Fbotw-re-notes/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/leoetlino%2Fbotw-re-notes/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/leoetlino","download_url":"https://codeload.github.com/leoetlino/botw-re-notes/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249145418,"owners_count":21219966,"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":["botw","breath-of-the-wild","ida-pro","nintendo-switch","reverse-engineering","zelda"],"created_at":"2024-11-28T15:19:21.011Z","updated_at":"2025-04-15T20:13:47.993Z","avatar_url":"https://github.com/leoetlino.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Breath of the Wild reverse engineering notes\n\n## What's in this repository?\n\n* Information and sometimes documentation about game internals. These files have the \\*.md extension\nin this repository. **Note: New documentation will be posted on the [ZeldaMods](https://zeldamods.org/) wiki instead to make it easier to update information for everybody.** Existing documentation is also being moved and will only be updated on the wiki.\n\n* Some plain text files that were extracted from the executable or generated from the ROM,\ncontaining information about game internals as well.\n\n* Tools for understanding some game files in [tools](tools/).\n\n* Tools and IDA scipts for reverse engineering the game and dumping structures/values\nfrom the executable in [tools/ida](tools/ida).\n\n* [A 010 Editor Template for beco files](tools/beco.bt), which are used to map coordinates to\nmap areas and/or tower areas.\n\n* Some code snippets in [code](code/). I usually rewrite the function in C++ to make game logic easier to understand, since optimised code is hard to read. Sometimes the snippet is just pseudocode output from Hex-Rays. (A lot of snippets are currently in my gists, but I'll probably move them to this repo in the future)\n\n## Tools\n\nOriginally this repository also contained a lot of tools for working with the ROM,\nsuch as a SARC archive reader and a library to manipulate the RSTB.\n\nThese have been moved to their own repositories to make them more reusable and easier to install:\n\n* [byml](https://github.com/leoetlino/byml-v2): library and CLI tools to convert between YAML and BYML (binary YAML)\n* [sarc](https://github.com/leoetlino/sarc): library and CLI tool to create, extract and update SARC archives\n* [rstb](https://github.com/leoetlino/rstb): library and CLI tool to query and edit the Resource\nSize Table (RSTB)\n* [botwfstools](https://github.com/leoetlino/botwfstools) (contentfs, overlayfs, edit, patcher):\ntools that make it easier to explore the romfs and edit files by exposing archives as directories\nand fixing the RSTB automatically\n\nThe following projects might also be helpful for playing with *Breath of the Wild* files:\n\n* [aamp](https://github.com/leoetlino/aamp): library and CLI tools to convert between YAML and AAMP (Nintendo binary parameter archives)\n* [evfl](https://github.com/leoetlino/evfl): library for manipulating Breath of the Wild's Event Flow files\n* [EventEditor](https://github.com/leoetlino/event-editor): graphical editor for Event Flow files\n\nThese can all be installed with `pip install \u003cname of the project\u003e`. Usage information is available\nin their respective repositories.\n\n## Credits\nThanks to MrCheeze for botw-tools, the object map and Zer0XoL for BotW-aampTool.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleoetlino%2Fbotw-re-notes","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fleoetlino%2Fbotw-re-notes","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fleoetlino%2Fbotw-re-notes/lists"}