totk-mobile README

README проекта с github.com/OJZen/totk-mobile. Одним файлом markdown: README.md.

Zelda-Mobile

English | 简体中文

Zelda-Mobile runs the Nintendo Switch release of The Legend of Zelda: Tears of the Kingdom v1.4.3 natively on Apple silicon Macs and iPads, with an early iPhone build. The game's ARM64 code executes directly on the Apple CPU, system services are reimplemented by the host, and NVN graphics commands are translated to Metal. The Mac and iOS front ends share one core.

[!IMPORTANT] 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
Apple silicon Mac Loading saves and playing scenes, keyboard and Xbox controller (with rumble), audio, cutscenes, 30 / 60 / 90 FPS targets The first visit to a new area or camera angle may stutter while shaders compile; not every area holds 60 FPS
iPad (M1 or newer) Development-signed install, resource import, loading saves, touch controller, camera, audio Well below 60 FPS at the original resolution; the first shader preparation takes a long time; hardware controllers are not fully validated
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

Quick start (Mac)

See Building and running for the full steps and troubleshooting. In short:

git clone https://github.com/OJZen/totk-mobile.git
cd totk-mobile
brew install cmake pkg-config opus libvpx [email protected]
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.

The first launch prepares tens of thousands of shaders. This can take several minutes or longer; the startup screen shows each stage and its progress. Later launches reuse the cache.

Controls

Action Keyboard
Move / camera W A S D / I J K L
A / B / X / Y X (confirm) / Z (back) / R / F
L / R, ZL / ZR Q / E, Shift / Space
Inventory (+) / map (−) Return / Tab
Control panel / performance overlay / full screen ⌘, / ⌘P / ⌃⌘F

Xbox controllers connect automatically over Bluetooth or USB. Frame rate, resolution, MetalFX, sound and rumble are set in the control panel (⌘,). See Controls and settings.

Saves

Saves live in work/save/ inside the project and use the same format as the console. See Saves for importing and backing up. Do not modify this directory while the game is running.

FAQ

Startup takes a long time. The first shader preparation is slow; the startup screen shows the current stage and its progress, and during play the performance overlay (⌘P) shows shader activity. The log is work/logs/native-probe.log.

A preparation script reports a module or version mismatch. Make sure the update is v1.4.3 and that local/games/ holds exactly one base game and one update.

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

License

The original code in this repository is licensed under the Apache License 2.0. Reused third-party components keep their own licenses; see Third-party notices.

Credits

Zelda-Mobile was built with d2r-mobile as its reference project: the loader, the ARM64 module rewriter and the NVN → Metal backend follow its design, and the files this project builds on are included in core/ under its MIT license. It also draws on public work from Ryujinx, libnx, Switchbrew, SPIRV-Cross, hactool and others. See Third-party notices for details.

"The Legend of Zelda", "Tears of the Kingdom" and "Nintendo Switch" are trademarks of Nintendo.

totk-mobile (OJZen/totk-mobile)

Ищем в базе…

Что это такое?Это экспериментальный нативный порт игры Nintendo Switch The Legend of Zelda: Tears of the Kingdom (v1.4.3), который работает напрямую на Mac и iPad с чипами Apple silicon; сборка для iPhone находится в разработке.
Это эмулятор или игра запускается с оригинального кода напрямую?Это не классический эмулятор: машинный код игры ARM64 выполняется непосредственно на процессоре Apple, системные службы реализованы заново на стороне хост-системы, а графические вызовы консоли NVN переводятся в Metal.
Как запустить это на моём Mac?На Mac с чипом Apple silicon, где установлены Xcode, инструменты командной строки и Homebrew, соберите проект, а затем дважды щёлкните launch.command (или запустите его в терминале); quick-load.command также автоматически загружает первый слот сохранения.
Что мне нужно, чтобы реально играть через это?Вам нужно самостоятельно предоставить снятый с диска дамп базовой версии Tears of the Kingdom и обновление v1.4.3 (.nsz), а также соответствующие файлы prod.keys, снятые с вашей собственной консоли; в репозитории намеренно не включены файлы игры, обновления, ключи или сохранения.
Работает ли это на Intel Mac и есть ли другие шероховатости?Нет, нужен Apple silicon, так как код игры выполняется нативно как ARM64. Даже на поддерживаемом оборудовании первое посещение новой локации может подтормаживать из-за компиляции шейдеров, а полное прохождение игры пока не проверено.
Насколько хорошо это работает на iPhone и iPad по сравнению с Mac?Mac — самая полноценная платформа с играбельными сценами, поддержкой контроллеров и звука; iPad (M1 и новее) работает, но заметно ниже 60 FPS; сборка для iPhone 15 Pro доходит только до титульного экрана при «тёплом» запуске, а геймплей и производительность пока не измерены.
Весь код проекта распространяется под одной лицензией?Собственный код проекта распространяется по лицензии Apache License 2.0, но повторно использованные сторонние компоненты, на которых он основан, сохраняют свои отдельные лицензии.
Почему в репозитории нет файлов самой игры?Игра принадлежит Nintendo, поэтому проект публикует только собственный код обратного инжиниринга; предполагается, что игроки снимут дамп со своей купленной копии и ключей со своей консоли.
На чём основан этот проект?Он использует d2r-mobile как эталонную архитектуру для загрузчика, переписывателя модулей ARM64 и бэкенда NVN-to-Metal, а также опирается на открытые наработки Ryujinx, libnx, Switchbrew, SPIRV-Cross и hactool.
Сколько места на диске нужно зарезервировать?Примерно 60 ГБ свободного места: одна только распакованная RomFS занимает около 16 ГБ, а кэш шейдеров и артефакты сборки добавляют заметно больше.
Как управлять игрой на Mac?Камеру двигают клавиши WASD или IJKL, X/Z/R/F соответствуют кнопкам A/B/X/Y, Q/E и Shift/Space отвечают за плечевые триггеры, а контроллеры Xbox подключаются автоматически по Bluetooth или USB и поддерживают вибрацию.
Какие есть похожие проекты?Wind-Waker-Recomp, S2Arm, pokemon-fulldex, MacNativeGames, nxnative, NX2Apple, Henge, muguet
Автор
OJZen
Размер
1.5 MB
Звёзды
223
Обновлён
КоммитOct 21
Возраст
1 мес
Коммиты · 90 дней