ly05010419/MacNativeGames

选用指南

AI 根据 README 整理 · 2026/10/18 16:56:13

使用方式

通过命令行脚本构建，使用 Python 3.14 运行 build_app.py 并指定游戏文件和密钥。

查看 README 依据

brew install opus libvpx python@3.14 ``` **2. Download or clone this repository**, then open Terminal in its `MacNativeGames` folder and run the script with your game file and keys: ```sh python3.14 build_app.py ~/Games/totk.xci -k ~/keys/prod.keys ``` For an NSP, supply the shared fonts too: ```sh python3.14 build_app.py ~/Games/totk.nsp -k ~/keys/prod.keys --firmware ~/Games/firmware # Or reuse the six .bfttf files from a previous build: python3.14 build_app.py ~/Games/totk.nsp -k ~/keys/prod.keys --shared-fonts /path/to/TOTK_build/totk/extracted/firmware/shared-fonts ```

部署要求

需要 Apple 芯片 Mac、macOS 26 或更高版本，建议 16 GB 内存，约 25 GB 磁盘空间，以及游戏本体文件和 prod.keys。

查看 README 依据

**iPhone and iPad support is coming soon. iPhone 16 or newer models are recommended for the upcoming iPhone version.** ## What you need - A Mac with Apple silicon and **macOS 26** or later (the graphics use Metal 4). 16 GB of memory or more is recommended. - About **25 GB** of free disk space for the work folder, in addition to your game file. Keep the output app on the **same APFS volume** to share the large data files through cloning. If cloning is unavailable or the app is on another volume, allow roughly **17 GB more** for the app copy.

- Your Tears of the Kingdom **base game 1.0.0** (`0100F2C0115B6000`) as an **XCI or NSP**, and your `prod.keys`. To build **1.1.2 or 1.4.3**, supply its separate cumulative update as NSP or NSZ with `--update`; no intermediate update is required. NSZ is decompressed and its NCA hashes are verified before extraction. DLC and combined packages are unsupported.

已知限制

仅支持 Mac，不支持 DLC、合并包、压缩本体和个性化票据，无联网功能和 amiibo。

查看 README 依据

## Known issues - Supports base 1.0.0, or base plus the separate 1.1.2 or 1.4.3 update NSP/NSZ. Other versions, DLC, combined packages, compressed base games (NSZ/XCZ) and personalized tickets remain unsupported. Mac only. - No online features, no amiibo. - New shaders can cause compilation stutters. Cache reuse reduces these, but does not guarantee stutter-free gameplay.