# Wind Waker HD Recomp：通过静态重编译实现的 Wii U 游戏原生移植

> 将《塞尔达传说 风之杖 HD》Wii U 版的 PowerPC 代码预先静态重编译为 C，原生重新实现游戏所用的 Cafe OS 库，并在 Metal 或 Vulkan 上实现 GX2 图形，生成无需 Cemu 运行时的 macOS、Linux、Windows 和 Android 原生版本。所有游戏代码和数据都由使用者自己的转储在本地生成；另有仅限 macOS 的实验性构建，可改为运行独立的 ZeldaWWHDDecomp/wwhd 反编译中的函数。

- 类型：案例
- 目标：游戏
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-10-18
- 收录于：2026-10-18
- 原始资源：<https://github.com/ZeldaWWHDRecomp/ZeldaWWHDRecomp>
- 一手来源：<https://github.com/ZeldaWWHDRecomp/ZeldaWWHDRecomp/blob/f10b56621ed13e0053e7cf8190e740834377e45a/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/wind-waker-hd-recomp-case/>
- 记录 JSON：<https://awesomerea.org/resources/wind-waker-hd-recomp-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/wind-waker-hd-recomp-case/index.md)

## 使用条件与局限

- **前提条件：**需要使用者自己合法取得的游戏：附有光盘密钥和 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。
- **范围：**README 说明该项目是对美版或欧版 Wii U 发行版（版本 0，不含更新）的静态重编译，并报告游戏在 macOS、Windows、Linux 和 Android 上均可从头玩到尾。已知缺口包括尚未实现的几何着色器和矩形图元，以及 macOS 上尚不支持手柄震动；真 60 fps 仍为实验性。与 zeldaret/tww 等源码反编译不同，默认构建运行的是机器转换的游戏代码。
- **测试证据：**项目报告的检查包括与 Cemu 并排比较渲染效果、玩家已通关，以及在反编译路径上由 tools/verify 以生成输入和录制输入，逐函数比较手写 C++ 与重编译原版的行为。实验性反编译构建（仅 macOS、仅美版）在固定的子模块版本中运行 862 个单元内的 22,705 个已验证函数。所有结果均为项目报告。
- **许可：**项目代码采用 MPL-2.0；内置的 Cemu 代码为 MPL-2.0，metal-cpp、{fmt}、Dear ImGui、zstd 及 AppImage 运行时组件各自保留其许可证，游戏仍归任天堂所有。README 称其为非官方粉丝项目。

## 一手来源

1. <https://github.com/ZeldaWWHDRecomp/ZeldaWWHDRecomp/blob/f10b56621ed13e0053e7cf8190e740834377e45a/README.md>
2. <https://github.com/ZeldaWWHDRecomp/ZeldaWWHDRecomp/blob/f10b56621ed13e0053e7cf8190e740834377e45a/docs/how-it-works.md>
3. <https://github.com/ZeldaWWHDRecomp/ZeldaWWHDRecomp/blob/f10b56621ed13e0053e7cf8190e740834377e45a/docs/decomp-build.md>
4. <https://github.com/ZeldaWWHDRecomp/ZeldaWWHDRecomp/blob/f10b56621ed13e0053e7cf8190e740834377e45a/tools/verify/README.md>
5. <https://github.com/ZeldaWWHDRecomp/ZeldaWWHDRecomp/blob/f10b56621ed13e0053e7cf8190e740834377e45a/LICENSE>
6. <https://github.com/ZeldaWWHDRecomp/ZeldaWWHDRecomp/blob/f10b56621ed13e0053e7cf8190e740834377e45a/.gitmodules>

## 同分区更多条目：游戏

- [Zelda 64: Recompiled：无需完整源码反编译的《姆吉拉的假面》原生移植](https://awesomerea.org/zh/resources/zelda64recomp-case/index.md) · 案例
- [2 Ship 2 Harkinian：基于反编译的《姆吉拉的假面》原生移植](https://awesomerea.org/zh/resources/2ship2harkinian-mm-port-case/index.md) · 案例
- [3SX：延续 PS2 反编译的《街头霸王 III：3rd Strike》原生移植](https://awesomerea.org/zh/resources/3sx-third-strike-native-port-case/index.md) · 案例
- [Animal Crossing：基于 GameCube 反编译成果的原生 PC 移植](https://awesomerea.org/zh/resources/animal-crossing-pc-port-case/index.md) · 案例
- [Atlantis Native：将 Atlantis 与 Atlantis II 引擎移植到 Rust](https://awesomerea.org/zh/resources/atlantis-native-case/index.md) · 案例
- [BattleShip：AI 辅助的 Super Smash Bros. 原生移植](https://awesomerea.org/zh/resources/battleship-port-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。
