# MacNativeGames - 塞尔达王国之泪原生跑上Apple芯片Mac（不是模拟器，M4实测90帧）

> 自己的TOTK游戏文件跑个脚本就变Mac原生App，游戏ARM64代码直接跑在M芯片上，M4实测90帧菜单120帧，D2R Mobile同源技术第二个落地

# MacNativeGames — 塞尔达王国之泪原生跑上 Apple 芯片 Mac（不是模拟器）

一句话：把你自己的《王国之泪》游戏文件（XCI/NSP + prod.keys）丢进去跑一个脚本，产出一个 macOS 原生 App——游戏的 ARM64 代码直接跑在 M 芯片上，M4 实测预热后约 90 帧、菜单 120 帧。

## 它是什么

MacNativeGames（159★，MIT，发布仅两天，10月17-18连更）是一个 Switch 游戏原生移植打包器，目前只支持《塞尔达传说：王国之泪》。跟模拟器的本质区别和 D2R Mobile 一个路数：

- **原程序直接跑**：TOTK 本身就是 ARM64 代码，Mac 的 M 芯片直接执行，只改写 macOS 不允许的少数指令——物理、掉落、任务流程和原版完全一致
- **Switch 系统服务**由一个小型 Host 层应答
- **NVN 图形**在 Metal 4 上重建（需要 macOS 26+）
- Ryujinx 的着色器翻译器被 NativeAOT 预编译进包里，把 Maxwell shader 转 SPIR-V 再转 Metal
- 仓库不含任何游戏内容，需要你自备正版游戏文件和密钥

## 实测表现（作者本机，M4）

| 项目 | 数据 |
|---|---|
| 测试机 | MacBook Air M4 / Mac mini M4 |
| 帧率 | 着色器预热后约 90 FPS，菜单 120 FPS |
| 首启预热 | 构建时打包 8000+ 着色器，首次 GPU 预热数分钟（1.4.3 为 8290 个） |
| 构建耗时 | M4 mini 上本体构建约 6 分钟（不含着色器准备） |
| 画面 | 原生 2K 画布 + MetalFX 放大/补帧可选（按 3 切换） |
| 存档 | 支持存读档、死亡重试、神庙进出；升级前自动备份存档 |

注意：新场景首次进入会因着色器现编卡顿，属预期现象，缓存预热后明显改善。这些是早期本机观察，不是全游戏稳定帧率认证。

## 需要准备

- Apple 芯片 Mac，**macOS 26+**（Metal 4），建议 16GB+ 内存
- 你自己的 TOTK **本体 1.0.0**（XCI 或 NSP）+ `prod.keys`
- 支持 1.0.0 / 1.1.2 / **1.4.3**（10月18日最新，`--update` 提供累计更新包即可）
- 磁盘：工作目录约 25GB，NSP 输入还要额外提供共享字体（`--firmware` 或 `--shared-fonts`）
- DLC、合并包、压缩格式（NSZ/XCZ 本体）不支持；无联机、无 amiibo

## 三步打包

```bash
# 1. 一次性装工具
xcode-select --install
brew install opus libvpx python@3.14

# 2. 克隆仓库，进目录跑脚本（游戏文件+keys 作为参数，具体命令见 README）
#    产出：Tears of the Kingdom.app

# 3. 访达双击 App 开玩
```

作者明确建议：**直接让 Claude Code / Codex 等 AI 助手帮你完成构建**——README 中文说明齐全，构建过程全是脚本自动校验（哈希不匹配就停，密钥不落日志）。

## 键位与操作

- 手柄：macOS 认识的手柄（DualSense/Xbox）自动映射成 Switch Pro 布局，支持震动/体感（视手柄）
- 键盘：WASD 左摇杆、I 跳跃 U 攻击、Option/Shift 对应 ZL/ZR，完整映射见 README
- 快捷键：`1` 叠层开关（FPS/着色器数），`2` 补帧循环，`3` 画质模式（MetalFX 2K → 原生 2K → 关）

## 技术渊源

作者在致谢里写明：NSO 改写器、Horizon 宿主、NVN-on-Metal 三大件**起步于本站之前发过的 D2R Mobile**（暗黑2上iPhone/Mac 那个项目，/p/2330）的通用部分；打包脚本参考 nxnative；着色器翻译来自 Ryujinx。同一技术路线，第二个游戏落地——这条"Switch 游戏原生上苹果芯"的路正在被快速复用，iPhone/iPad 版已在路上（推荐 iPhone 16+）。

## 链接

- GitHub：https://github.com/ly05010419/MacNativeGames

---

**分类**：游戏
**标签**：游戏 · 原生 · Mac
**作者**：子龙
**链接**：https://octohz.com/p/2339