Software:The Legend of Zelda: Breath of the Wild
| Developer | Nintendo EPD |
|---|---|
| Publisher | Nintendo |
| Uses | Library:sead |
| Platforms | Platform:Nintendo Switch |
| Versions | 1.5.0 (decompilation target), 1.6.0, 1.9.0 |
| On this wiki | Facts · Code · Notes · Topics |
Nintendo's 2017 open-world Zelda (internal project name UKing) for Nintendo Switch. zeldaret/botw is a work-in-progress decompilation of the v1.5.0 executable, with a CSV list of about 113,000 functions and their decompilation status.
Overview
The Switch version is an AArch64 Format:NSO (main) plus a few small modules. The community decompilation https://github.com/zeldaret/botw targets version 1.5.0 and states that it contains no game assets and cannot be used to play the game (README). The build system is Tool:nx-decomp-tools (submodule tools/common); the decomp.me preset in tools/config.toml names clang 4.0.1 with -x c++ -O3 -g2 -std=c++1z -fno-rtti -fno-exceptions. It uses the sead framework (Library:sead, submodule lib/sead) and header reconstructions of Nintendo libraries (submodules lib/NintendoSDK, lib/nnsdk, lib/nnware, lib/agl, lib/EventFlow, lib/xlink2).
Which executable
tools/setup.py accepts the main NSO of three game versions, each either compressed (as shipped) or uncompressed, identified by SHA-256 (the target is the uncompressed 1.5.0 file, see Build:The Legend of Zelda: Breath of the Wild/1.5.0 (Nintendo Switch, retail)):
| Version | Compressed NSO | Uncompressed NSO |
|---|---|---|
| 1.5.0 | 898dc199301f7c419be5144bb5cb27e2fc346e22b27345ba3fb40c0060c2baf8 | d9fa308d0ee7c0ab081c66d987523385e1afe06f66731bbfa32628438521c106 |
| 1.6.0 | 15cfca7b89348956f85d945fade2e215a6af5991ed1071e181f97ca72f7ae20b | 8a2fc8b1111a35a76fd2d53a8670599da4a7a9706a3d91215d30fd62149f00c1 |
| 1.9.0 | f6f0b20bb1f2b67d164c24871cd473147eef1d285f12e7bd492e3126c6022e27 | 6a30c162a2e6f885e0b1c0a6673a84795549a5ccdec1de8d3a741168ac4cba86 |
The 1.6.0 and 1.9.0 executables are converted to the 1.5.0 one by downloading an xdelta3 "downgrade" patch (function _download_downgrade_to_v150_patch in tools/setup.py), so every address in the project refers to 1.5.0.
Symbols and addresses
data/uking_functions.csv has the header Address,Quality,Size,Name; addresses are written as 0x00000071xxxxxxxx, that is the offset in the module plus 0x7100000000 (see Format:NSO#Address mapping in decompilation projects). Size is a decimal byte count. Many rows have an empty Name. The wiki's symbol map for the 1.5.0 build holds the 72,278 named rows (41 names skipped by the importer) at that commit, see Build:The Legend of Zelda: Breath of the Wild/1.5.0 (Nintendo Switch, retail). data/data_symbols.csv lists about 520 data symbols (address, mangled name), for example sead's Matrix34f::ident.
Quality column: the file has the values O, m, M, W, L and U. Meanings, read in tools/common/util/utils.py of Tool:Nx-decomp-tools (open-ead/nx-decomp-tools, master at e0eae2f7f403): O = matching (byte-identical), m = equivalent (semantically equivalent but not perfectly matching), M = non-matching, W = work in progress, U = not decompiled, L = library function (counted as not decompiled, and skipped by default when the tools read the CSV). Any other letter is treated as not decompiled. Unverified: the exact criteria for choosing m over M are not documented in the files I read. Counts at the pinned commit: U 66,886; O 32,213; W 7,586; L 6,271; M 360; m 175.
The repository has no LICENSE file at the pinned commit, so only symbol names and addresses were taken from it.
Code & repositories
- https://github.com/zeldaret/botw @
28de09ade7a2ac4c9fc22c82edad348555617181· license: none
Work-in-progress decompilation of Breath of the Wild 1.5.0: data/uking_functions.csv (Address,Quality,Size,Name), data_symbols.csv, tools/setup.py with the NSO SHA-256 hashes.
Tested on: source read, not run: Breath of the Wild 1.5.0 (Switch) · checked 2026-10-18; last activity 2026-10-18; no license: not reusable