GreenKid-MV 0.3.0-preview

Experimental preview. GreenKid-MV is a game-free Mac builder: you point it at your own legally obtained Ocarina of Time (Switch 2) dump, and it builds a private game app locally on your Mac. No game files, keys or game assets are included or downloaded.

What's new in 0.3.0

Prompted by issue #1 (thanks, JDSavvy): the engine moved to upstream seedds/nxnative main ab41d6a1, 45 commits newer than 0.2.0.

• Memory and swap: a GPU buffer retired while the game window is in the background is released right away, instead of GPU memory and swap growing (upstream #1919). Upstream also removed a 6.7 GB Metal memory spike during area loads.
• Terrain: upstream's landed terrain fix (#1920), no more "plaid" stripes after entering and leaving dungeons, and streamed scenery (castle town wall, Hyrule Castle, Lon Lon Ranch) no longer flashes dark or black.
• Death Mountain: upstream's landed depth rule for the light-blue dashes (#1917).
• Smoother: Hyrule Field's 230 ms camera-turn hitch is down to 39 ms; 41 more pipelines are prepared ahead for Death Mountain Trail; the host is built at -O2; fullscreen on ProMotion screens holds 60 FPS.
• Easier setup: the .NET SDK is no longer needed.
• New icon: the GreenKid-MV green hat.
• GreenKid-MV's own additions carry over: Normal / Potato resolution presets, game-file overlays, MetalFX for the game's upscaler, the GPU-hang watchdog, CPU savings and the cool 60 FPS settings.

Download

• GreenKid-MV-0.3.0-preview-macOS-arm64.zip: the builder app (Apple silicon).
• GreenKid-MV-0.3.0-preview-source.zip: the matching source snapshot (engine greenkid-v2.1-564653c85030).
• SHA256SUMS.txt: checksums for both ZIPs.

Requirements

• Apple silicon Mac with macOS 26.6 or later, Xcode 27.2 and its Metal Toolchain.
• Homebrew tools: brew install uv xcodegen zstd glslang.
• Your own dump of the game with update v131072.

The app is ad-hoc signed, not notarized. On first launch, right-click it and choose Open, or allow it under System Settings → Privacy & Security. Because the shader translation changed, a first build compiles every shader again (about an hour on an M5 Air).

Known limits

• Performance depends on your Mac, dump and area; sustained 60 FPS is not guaranteed on every machine.
• Building needs a lot of disk space (about 100 GB free is safe).
• Chromium-based browsers (Chrome, Comet, Brave, Edge) can grab Xbox-style USB controllers while the game runs; quit them if your controller drops.

Credits

All engine work belongs to its upstream authors: seedds, cheemu21, Xipzer and the contributors listed in CREDITS.md and AUTHORS.md, including 12 new names for this release. This is an unofficial project, not affiliated with or endorsed by Nintendo.

GreenKid-MV 0.2.0-preview

Experimental preview. GreenKid-MV is a game-free Mac builder: you point it at your own legally obtained Ocarina of Time (Switch 2) dump, and it builds a private game app locally on your Mac. No game files, keys or game assets are included or downloaded.

What's new in 0.2.0

• New engine: moved from the old cheemu21 pin to the latest seedds/nxnative main (2a6f9b32, all 187 upstream commits), plus the Ocarina of Time fixes from open upstream pull requests.
• Lighting flicker fixed in testing, along with terrain fixes, a working MetalFX upscaler chain, crash fixes and a GPU-hang watchdog.
• Lower CPU use: smarter reuse of buffer checks and render-pass snapshots, so a fanless Mac stays cooler.
• Cooler default settings: each build writes fixed resolution, display-synced pacing, a 60 FPS cap and simple window scaling. You can still change them in the settings file.
• Resolution presets kept (Normal 720p and a lighter Potato preset).

Download

• GreenKid-MV-0.2.0-preview-macOS-arm64.zip: the builder app (Apple silicon).
• GreenKid-MV-0.2.0-preview-source.zip: the matching source snapshot (engine greenkid-v2-73463569c5e7).
• SHA256SUMS.txt: checksums for both ZIPs.

Requirements

• Apple silicon Mac with macOS 26.6 or later, Xcode 27.2 and its Metal Toolchain.
• Homebrew tools: brew install uv xcodegen zstd glslang and brew install --cask dotnet-sdk.
• Your own dump of the game with update v131072.

The app is ad-hoc signed, not notarized. On first launch, right-click it and choose Open, or allow it under System Settings → Privacy & Security.

Known limits

• Performance depends on your Mac, dump and area; sustained 60 FPS is not guaranteed on every machine.
• Building takes a long time and needs a lot of disk space, because every shader is compiled locally.

Credits

All engine work belongs to its upstream authors: seedds, cheemu21 and the contributors listed in CREDITS.md and AUTHORS.md, including about 50 new names for this release. This is an unofficial project, not affiliated with or endorsed by Nintendo.

GreenKid-MV 0.1.0-preview

Experimental preview. GreenKid-MV is a game-free Mac builder: you point it at your own legally obtained Ocarina of Time (Switch 2) dump, and it builds a private game app locally on your Mac. No game files, keys or game assets are included or downloaded.

Download

• GreenKid-MV-0.1.0-preview-macOS-arm64.zip: the builder app (Apple silicon).
• GreenKid-MV-0.1.0-preview-source.zip: the matching source snapshot.
• SHA256SUMS.txt: checksums for both ZIPs.

Requirements

• Apple silicon Mac with macOS 26.6 or later, Xcode 27.2 and its Metal Toolchain.
• Homebrew tools: brew install uv xcodegen zstd glslang and brew install --cask dotnet-sdk.
• Your own dump of the game with update v131072.

The app is ad-hoc signed, not notarized. On first launch, right-click it and choose Open, or allow it under System Settings → Privacy & Security.

What's inside

• Engine pinned to e9c2f7e1 from cheemu21/kid-with-sword-remake, based on seedds/nxnative. It includes the upstream shader-synchronization fix, frame buffering and resolution presets (Normal 720p, plus a lighter Potato preset).
• A Mac builder window: pick your dump folder, build, and open the private output.
• Publication checks that keep game files out of the repository and the release ZIPs.

Known limits

• Sustained 60 FPS and lighting correctness are not certified for this release. Results depend on your Mac, dump and area.
• An end-to-end first build on a fresh machine has not been tested yet.
• Building takes a long time and needs a lot of disk space, because every shader is compiled locally.

Credits

All engine work belongs to its upstream authors: seedds, cheemu21 and the contributors listed in CREDITS.md and AUTHORS.md. This is an unofficial project, not affiliated with or endorsed by Nintendo.