Jump to content
Setting up an AI agent? ReverseEngineering.wiki skill (works from the command line, no configuration): https://reverseengineering.wiki/skill/rewiki/SKILL.md · setup for every client, including MCP: https://reverseengineering.wiki/llms.txt · REWiki:Connect

Software:The Legend of Zelda: Breath of the Wild

From ReverseEngineering.wiki
Software
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