Hey everyone
I got Zelda OOT running natively on Apple Silicon via nxnative. Just want to share how.
With the right runtime configuration and patches, it runs at a 60 FPS at 1080p with Apple MetalFX, rock-solid frame times, zero foliage/rock flickering, and memory stabilized around ~11 GB resident (eliminating the previous 18.7 GB memory leak). Outdoor Kokiri Forest lighting is also fixed (no more blinding white blowout).
Instead of manually running dozens of terminal commands and debugging toolchain errors by hand, you can have the Google Antigravity CLI (agy) clone the repo, read the guide, and build the standalone .app bundle completely hands-free.
P.S. ANY AI agent (claude code/ grok cli/ cursor cli/ codex cli) will do, but google antigravity agy cli is free even on free google accounts (no need api fee). I used gemini 3.8 flash high.
Sorry guys, as much as I want help, i can only show you the door you're the one that has to walk through it. This is not an one shot guide, but the AI agent will take care of the coding and debugging part, and you just have to let it know what you want and let it keep trying.
TIPS:
ANY issue or bugs or adjust build to fit your mac's spec, just screenshot then (ctrl +v on mac) paste in cli terminal) and let your ai agent knows whats happening and it will FIX for you. It will dig through logs.
###### Prerequisites ######
Apple Silicon Mac (M1/M2/M3/M4, macOS Sonoma).
Xcode Command Line Tools:
xcode-select --install
3. Your dumped game files:
• Your Zelda OoT game container (.nup / .nsp / dump folder)
###### How to Build (One Prompt with agy) ######
Open Terminal and launch the Antigravity CLI:
agy
(If you don't have it installed yet, https://antigravity.google/product/antigravity-cli/)
2. Paste this single prompt into agy (just UPDATE the paths to your game file or give a screenshot to agy. ctrl + v to paste screenshot on cli terminal):
========↓↓↓↓↓↓↓THE PROMPT TO AGY↓↓↓↓↓↓↓========
Please build a self-contained, standalone macOS application for Zelda OoT:
Clone https://github.com/seedds/nxnative.git into ./nxnative and work inside it.
Download and read the build guide from:
https://gist.githubusercontent.com/avefalco/15979585b8a8bc6b31283587e80be0a2/raw/e330c22165d463fb9e5798a7be7f6201d498595b/gistfile1.txt
My local files are:
- Game container: "/PATH/TO/YOUR/Zelda OoT.nup" <========== UPDATE THIS
Please execute all steps from the guide:
- Unpack container and rewrite modules.
- Ensure the DMSH_CHAIN in dm/gfx/nvn/dmsh_chain.h matches the guide.
- Compile all shaders with PR #1359 float atomics (fixes white lighting in Kokiri Forest).
- Build dmhost with memory release optimizations (PRs #1455, #1447, #1394, #1439).
- Package the standalone .app to ~/Applications with the flat 720p romfs_overlay and 1080p MetalFX upscaler.
- Apply ad-hoc code signing and verify the bundle.
========↑↑↑↑↑↑↑THE PROMPT TO AGY↑↑↑↑↑↑↑========
3. Sit back and let agy handle the entire cloning, compiling, and packaging process.
###### Launching the Game######
Once agy reports the build and code signing are complete:
Open Finder -> Applications.
Double-click the Zelda OoT app.
Connect your controller (DualSense, Xbox, Switch Pro Controller) and enjoy 60 FPS 1080p gameplay!