OJZen/totk-mobile

选用指南

AI 根据 README 整理 · 2026/10/20 18:06:51

使用方式

通过命令行脚本准备资源和构建，然后通过 launch.command 启动游戏。

查看 README 依据

mkdir -p local/games local/keys # Put the base game and the v1.4.3 update in local/games/ and prod.keys in local/keys/, then: ./script/prepare.sh ./script/prepare_resources.sh local/keys/prod.keys ./script/prepare_shaders.sh ./script/build_and_run.sh --load-only ./launch.command ``` After that, start the game by double-clicking `launch.command` (or running it in a terminal). `quick-load.command` additionally walks the in-game menu and loads the first entry of the save list.

部署要求

需要 Apple 芯片 Mac（M1 或更新）并安装完整 Xcode、命令行工具和 Homebrew；约 60 GB 可用空间；需要自己拥有的《王国之泪》基础游戏和 v1.4.3 更新（.nsz）及匹配的 prod.keys。iPhone 或 iPad 需要 Apple 开发者签名团队、处于开发者模式的设备和 USB 连接。

查看 README 依据

| iPhone 15 Pro | Development-signed install, resource import, verified offline shader libraries, warm launch to the title screen | Gameplay, frame rate, memory and thermals have not been measured; no other iPhone has been tried, and chips without BC texture support (before A17 Pro) are untested | Only v1.4.3 is supported. The preparation scripts verify module fingerprints and refuse other versions. ## Requirements - An **Apple silicon Mac** (M1 or newer) with full Xcode, the command line tools and Homebrew.

- **About 60 GB of free space** (an external drive works). The extracted RomFS alone is about 16 GB; shader caches and builds need more. - Your own *Tears of the Kingdom* base game and **v1.4.3 update** (`.nsz`), plus the matching `prod.keys`. - For iPhone or iPad: an Apple developer signing team, a device in Developer Mode and a USB connection. ## Quick start (Mac) See [Building and running](docs/getting-started.md) for the full steps and troubleshooting. In short: ```sh git clone https://github.com/OJZen/totk-mobile.git cd totk-mobile brew install cmake pkg-config opus libvpx python@3.14

已知限制

项目处于活跃开发中，可加载存档并游玩，但完整通关尚未验证。仅支持 v1.4.3 版本，准备脚本会验证模块指纹并拒绝其他版本。不支持 Intel Mac。

查看 README 依据

> This project is not affiliated with, authorized or endorsed by Nintendo. The repository contains **source code only**: no game files, updates, keys, saves, game shaders or any other game-derived data, and no instructions for obtaining them. Use only a game and keys that you own and dumped from your own console. ## Status The project is under active development. You can load a save and play, but a full playthrough has not been validated. | Platform | Working | Known limits | | --- | --- | --- |

| iPhone 15 Pro | Development-signed install, resource import, verified offline shader libraries, warm launch to the title screen | Gameplay, frame rate, memory and thermals have not been measured; no other iPhone has been tried, and chips without BC texture support (before A17 Pro) are untested | Only v1.4.3 is supported. The preparation scripts verify module fingerprints and refuse other versions. ## Requirements - An **Apple silicon Mac** (M1 or newer) with full Xcode, the command line tools and Homebrew.

**The game stutters.** The first time a scene is seen, its pipelines are compiled on the spot and then cached. For sustained low frame rates, compare against the 1080 or 720 resolution setting in the control panel. **Does it run on Intel Macs?** No. The game code runs natively as ARM64 and needs Apple silicon. ## For developers - [Documentation index](docs/README.md) - [Building and running](docs/getting-started.md): full Mac, iPhone and iPad setup - [Source map](docs/architecture.md): components, generated files and where to make changes