{
  "added_at": "2026-10-18",
  "additional_evidence_urls": [
    "https://github.com/ZeldaWWHDRecomp/ZeldaWWHDRecomp/blob/f10b56621ed13e0053e7cf8190e740834377e45a/docs/how-it-works.md",
    "https://github.com/ZeldaWWHDRecomp/ZeldaWWHDRecomp/blob/f10b56621ed13e0053e7cf8190e740834377e45a/docs/decomp-build.md",
    "https://github.com/ZeldaWWHDRecomp/ZeldaWWHDRecomp/blob/f10b56621ed13e0053e7cf8190e740834377e45a/tools/verify/README.md",
    "https://github.com/ZeldaWWHDRecomp/ZeldaWWHDRecomp/blob/f10b56621ed13e0053e7cf8190e740834377e45a/LICENSE",
    "https://github.com/ZeldaWWHDRecomp/ZeldaWWHDRecomp/blob/f10b56621ed13e0053e7cf8190e740834377e45a/.gitmodules"
  ],
  "category": "reconstruction-cases",
  "description_en": "Statically recompiles The Wind Waker HD’s Wii U PowerPC code to C ahead of time, reimplements the Cafe OS libraries the game uses and implements GX2 graphics on Metal or Vulkan, producing native macOS, Linux, Windows and Android builds without a Cemu runtime. All game code and data are generated locally from the user’s own dump; an experimental macOS-only build can instead run functions from the separate ZeldaWWHDDecomp/wwhd decompilation.",
  "description_zh": "将《塞尔达传说 风之杖 HD》Wii U 版的 PowerPC 代码预先静态重编译为 C，原生重新实现游戏所用的 Cafe OS 库，并在 Metal 或 Vulkan 上实现 GX2 图形，生成无需 Cemu 运行时的 macOS、Linux、Windows 和 Android 原生版本。所有游戏代码和数据都由使用者自己的转储在本地生成；另有仅限 macOS 的实验性构建，可改为运行独立的 ZeldaWWHDDecomp/wwhd 反编译中的函数。",
  "entry_url": "https://awesomerea.org/resources/wind-waker-hd-recomp-case/",
  "entry_url_zh": "https://awesomerea.org/zh/resources/wind-waker-hd-recomp-case/",
  "evidence_url": "https://github.com/ZeldaWWHDRecomp/ZeldaWWHDRecomp/blob/f10b56621ed13e0053e7cf8190e740834377e45a/README.md",
  "group": "cases",
  "id": "wind-waker-hd-recomp-case",
  "json_url": "https://awesomerea.org/resources/wind-waker-hd-recomp-case/record.json",
  "kind": "case-study",
  "markdown_url": "https://awesomerea.org/resources/wind-waker-hd-recomp-case/index.md",
  "markdown_url_zh": "https://awesomerea.org/zh/resources/wind-waker-hd-recomp-case/index.md",
  "name": "Wind Waker HD Recomp: a native port by static recompilation of the Wii U game",
  "name_zh": "Wind Waker HD Recomp：通过静态重编译实现的 Wii U 游戏原生移植",
  "reconstruction_method": "static-recompilation",
  "record_type": "resource",
  "relationship": "independent-reconstruction",
  "requirement_facets": [
    "scope",
    "prerequisites",
    "prerequisites",
    "testing",
    "license"
  ],
  "requirements": [
    "README describes a static recompilation of the USA or European Wii U release (version 0, without the update) and reports the game playable from start to finish on macOS, Windows, Linux and Android. Known gaps include unimplemented geometry shaders and rectangle primitives and no controller rumble on macOS; true 60 fps is experimental. Unlike source decompilations such as zeldaret/tww, the default build runs machine-translated game code.",
    "Needs the user’s own, legally obtained game: a .wud/.wux disc image with its disc key and the Wii U common key, a Cemu .wua archive, or an extracted game folder. Setup checks code/cking.rpx against the SHA-256 of each supported version. The repository and releases contain no game code, assets or keys, and the locally generated code and caches must not be redistributed.",
    "Releases target Apple Silicon macOS 14+, Windows 10 1903+ or 11 on x86-64 or arm64, and glibc 2.35+ Linux on x86-64 or arm64, with Vulkan 1.3 (or 1.1/1.2 with VK_KHR_dynamic_rendering) where Vulkan is used; Android arm64 builds the game on the phone. First setup translates and compiles the code locally with a downloaded compiler (llvm-mingw on Windows, zig on Linux) or Apple’s command-line tools. Source builds need CMake 3.20+ and Python 3.",
    "Reported checks are side-by-side rendering comparison with Cemu, players completing the game and, for the decompiled path, tools/verify’s function-by-function comparison of hand-written C++ with the recompiled original on generated and recorded inputs. The experimental decomp build (macOS, USA game only) runs 22,705 verified functions in 862 units at the pinned submodule. All results are project-reported.",
    "Project code is MPL-2.0; vendored Cemu code is MPL-2.0, while metal-cpp, {fmt}, Dear ImGui, zstd and the AppImage runtime components keep their own licenses, and the game remains Nintendo’s property. README calls it an unofficial fan project."
  ],
  "requirements_zh": [
    "README 说明该项目是对美版或欧版 Wii U 发行版（版本 0，不含更新）的静态重编译，并报告游戏在 macOS、Windows、Linux 和 Android 上均可从头玩到尾。已知缺口包括尚未实现的几何着色器和矩形图元，以及 macOS 上尚不支持手柄震动；真 60 fps 仍为实验性。与 zeldaret/tww 等源码反编译不同，默认构建运行的是机器转换的游戏代码。",
    "需要使用者自己合法取得的游戏：附有光盘密钥和 Wii U 通用密钥的 .wud／.wux 光盘镜像、Cemu 的 .wua 归档，或已解包的游戏目录。设置程序会将 code/cking.rpx 与各受支持版本的 SHA-256 比对。仓库和发行包均不含游戏代码、素材或密钥，本地生成的代码与缓存不得再分发。",
    "发行版面向 macOS 14+（Apple Silicon）、x86-64 或 arm64 上的 Windows 10 1903+ 或 Windows 11，以及 x86-64 或 arm64 上 glibc 2.35+ 的 Linux；使用 Vulkan 时需 Vulkan 1.3（或支持 VK_KHR_dynamic_rendering 的 1.1／1.2）；Android arm64 版在手机上构建游戏。首次设置时，在本地用下载的编译器（Windows 为 llvm-mingw，Linux 为 zig）或 Apple 命令行工具转换并编译代码。从源码构建需 CMake 3.20+ 和 Python 3。",
    "项目报告的检查包括与 Cemu 并排比较渲染效果、玩家已通关，以及在反编译路径上由 tools/verify 以生成输入和录制输入，逐函数比较手写 C++ 与重编译原版的行为。实验性反编译构建（仅 macOS、仅美版）在固定的子模块版本中运行 862 个单元内的 22,705 个已验证函数。所有结果均为项目报告。",
    "项目代码采用 MPL-2.0；内置的 Cemu 代码为 MPL-2.0，metal-cpp、{fmt}、Dear ImGui、zstd 及 AppImage 运行时组件各自保留其许可证，游戏仍归任天堂所有。README 称其为非官方粉丝项目。"
  ],
  "targets": [
    "game"
  ],
  "url": "https://github.com/ZeldaWWHDRecomp/ZeldaWWHDRecomp",
  "verification": "source-reviewed",
  "verified_at": "2026-10-18"
}