STATIC RECOMPILATION / MagicBeanDev
Longshot
Longshot brings the Switch 2 version of The Legend of Zelda: Ocarina of Time to native Windows and Linux through static recompilation, with a launcher for building and updating from your own game.
The overview
Longshot continues Hookshot, with top maintainers moving to this project according to its README. It translates game code to C, builds a native PC program, reimplements console services and renders with Vulkan. This entry covers the Switch 2 game, not the Nintendo 64 original. Its documentation covers installation, hardware, settings, saves, mods and reported issues in detail.
System and game requirements
- Supported game: program 0400486024DEC000, update v131072, build e0f3ccfa. Supply your own .nup or romfs/ and exefs/ folders; other versions are unsupported.
- 64-bit Windows 10 / 11 or x86-64 Linux with glibc 2.35 or newer. AVX2 is required by the Linux AppImage; Windows and source builds can run without AVX2, more slowly.
- The README estimates a 6-core CPU, Vulkan 1.3 GPU, 4 GB VRAM, 16 GB RAM and about 60 GB free during building. These are estimates from reported configurations, not frame-rate guarantees. Mesh shaders and an SSD are recommended.
- Some Linux/NVIDIA reports use 13–19 GiB for the game alone. A 16 GB system may need swap and room for the desktop. Heavy swapping can make the machine unresponsive; swap is not extra physical RAM. Initial setup needs internet access for tools.
Features described by the developer
- Launcher-managed build, signed-checksum verification of Builder downloads, updates, save handling and portable operation; separate Stable, Release candidate and Nightly channels.
- Graphics options include quality presets from 4 GB to 16 GB+ VRAM, aspect ratios including ultrawide and 4:3, output/render resolution, DLSS/DLAA, FSR 3.1/4 and HDR where the build and GPU support them.
- The README lists frame caps of 60–240 FPS or uncapped, frame-generation choices up to 8x, frame pacing, Reflex and Anti-Lag 2 where available. Generated frames are not the same as the game’s rendered frame rate.
- Keyboard, mouse and controller remapping, controller button prompts, ocarina note bindings, optional toggle inputs and supported-controller rumble. RomFS mods are supported; exefs .ips/.pchtxt code patches are not.
Getting started
Get the Launcher from longshot.magicbean.dev/download. Windows offers a setup executable or portable ZIP; Linux offers LongshotLauncher-<version>-x86_64.AppImage. Grant the AppImage executable permission, then start it.
Choose Build the game and a channel. The README recommends Stable for play; until a stable release exists, the general launcher download may resolve to an RC. Check what version is offered. Nightlies are untested.
Select your own .nup or romfs/exefs folders, destination, game language and options. The launcher checks the version, downloads the Builder and compiles locally. Default game folders are Games/Longshot under your Windows user folder or ~/Games/Longshot on Linux.
Build with shader preparation enabled; Most is the README’s recommended shader setting. Wait for the build and preparation, then press Play. Time varies by CPU, storage and driver; first visits can still stutter.
Back up saves before Update. The launcher can rebuild using files kept from the first build without selecting the .nup again. Follow the upstream saves guide when migrating from Hookshot, an emulator or NX2navi.
Longshot — Downloads
Find maintainer-hosted files, package selection advice and recent releases on the dedicated download page.
Choose a package and check releasesMinimum and recommended hardware
Swipe horizontally to compare all columns.
| Component | Minimum estimate | Recommended in README |
|---|---|---|
| CPU | 6 cores: Ryzen 5 2600 / Core i5-8400 | Ryzen 5 5600 / Core i5-12400 or newer |
| GPU | Vulkan 1.3: GTX 1060 6 GB / GTX 1650, RX 5500 XT, Arc A380 | RTX 3060 / 4060, RX 6600 XT / 6700 XT, Arc A750; check known issues |
| Memory | 16 GB RAM, 4 GB VRAM; memory pressure remains possible | 16 GB+ RAM and 8 GB+ VRAM; leave room for the OS |
| Storage | About 60 GB free during building | SSD, about 60 GB free |
Reported compatibility and open issues
This is a summary of the README status table, not Switch2e testing. Much of the history comes from Hookshot. Reports from one scene or GPU do not establish full-game compatibility.
| Area / device | Upstream report |
|---|---|
| Kokiri Forest and basic play | Gameplay, sound, controls and saves reported working. |
| Hyrule Field, towns and dungeons | Players reached them; lighting, shadows, crashes and freezes remain open. |
| NVIDIA | The most-tested GPU family in the README. |
| AMD | Several cards reported; device-loss issues remain. Some RX 6000 Windows GPUs use a compute fallback by default. |
| Intel / no mesh shaders | Intel reports are limited, with black screens/crashes. Compute fallback can be slower and omit draws. |
| Linux / SteamOS | AppImage reported on several distributions; AMD and Steam Deck issues remain. AVX2 still applies. |
Controls and everyday settings
| Action | README guidance |
|---|---|
| Open settings | F1 always works; default shortcuts also include Insert / Esc. Gamepad: Home or Select + Start. |
| Move / camera | WASD moves; arrows or IJKL turn the camera. Default E selects New Game. |
| Menu tabs | Graphics, Audio, Gameplay, Controls and Debug. Q/E or controller shoulders switch tabs. |
| Shader preparation | Most is recommended. All adds predicted pipelines and takes longer, without guaranteeing fewer stutters. |
Saves, settings and mods
Only RomFS modifications load. Code patches (.ips/.pchtxt) do not. Larger replacement assets may require an updated resource-size table. Follow the saves guide to import/export from Hookshot, emulators or NX2navi; keep backups.
| Item | Location / rule |
|---|---|
| Windows saves | user/ inside the game folder. Back it up before updates. |
| Linux saves | ~/.local/share/longshot; migration from earlier user/ layouts is described upstream. |
| Settings / logs | longshot_options.ini and longshot_env.txt in the game folder; logs/longshot_log.txt. cache/ holds GPU-specific caches. |
| RomFS mods | mods/<name>/romfs/...; a - or _ prefix disables a mod. If files conflict, the last folder name alphabetically wins. |
Troubleshooting before reporting a bug
Gameplay → Bug report collects diagnostics. Include the version/channel, scene, GPU, driver and log when reporting upstream; do not attach game files. A configuration catalog is evidence about specific PCs, not a compatibility guarantee.
| Symptom | First checks from the README |
|---|---|
| Unsupported version | Check the game update and build e0f3ccfa; changing graphics settings cannot fix a wrong dump version. |
| New-area stutter | First encounters still compile shaders. Keep shader preparation enabled and check whether later visits improve. |
| Device lost / closes | Update the GPU driver and preserve logs. AMD and Intel have documented issues; record the card and driver. |
| Skipped shader preparation | Check cache/longshot_prepare_skipped. Upstream explains rebuilding with Prepare shaders now, or removing that marker to prepare at next start. |
| Wrong or missing surfaces | Look for longshot_damaged_files.txt and consult the dump-integrity and mesh-fallback notes. |
Recompilation questions
What is Longshot, and how is it related to Hookshot?
Longshot is a GPL-3.0-or-later continuation of Hookshot for native Windows/Linux static recompilation of the supported Switch 2 Ocarina of Time game. Its README says top maintainers moved to Longshot. You build locally from your own game; it is not an emulator.
Should I download the Longshot Launcher or Builder?
For normal setup, get the Launcher from longshot.magicbean.dev/download. It downloads the Builder, checks signed checksums, builds and updates the game. The repository’s Builder ZIP/AppImage is for the launcher or advanced CLI use and contains no ready-to-play game.
Is Longshot more complete than NX2navi?
The README documents many settings and player reports, but still calls Longshot experimental and lists crashes, rendering issues and hardware limits. Switch2e has not performed a controlled comparison, so it does not rank either project as more complete or faster.
Does Longshot run on Linux or guarantee 60 FPS?
The README reports native Linux AppImage operation on several distributions, including SteamOS. It requires glibc 2.35+ and AVX2 for the AppImage. Performance varies, mesh fallback can omit draws, and some areas need more memory than a 16 GB PC can spare. 60 FPS is not guaranteed.
Sources & review
Reviewed · README 5e072fc
- git.magicbean.dev/MagicBeanDev/Longshot
- git.magicbean.dev/MagicBeanDev/Longshot/src/commit/5e072fc8c2adadba5ea610148be1c47800ba0cca/README.md
- git.magicbean.dev/MagicBeanDev/Longshot/releases
- git.magicbean.dev/MagicBeanDev/Longshot/releases/tag/v3.0.0-rc.3
- git.magicbean.dev/MagicBeanDev/Longshot/src/commit/5e072fc8c2adadba5ea610148be1c47800ba0cca/README.md#what-you-need
- git.magicbean.dev/MagicBeanDev/Longshot/src/commit/5e072fc8c2adadba5ea610148be1c47800ba0cca/README.md#project-status
- git.magicbean.dev/MagicBeanDev/Longshot/src/commit/5e072fc8c2adadba5ea610148be1c47800ba0cca/README.md#install-and-play
- git.magicbean.dev/MagicBeanDev/Longshot/src/commit/5e072fc8c2adadba5ea610148be1c47800ba0cca/README.md#in-game-menu
- git.magicbean.dev/MagicBeanDev/Longshot/src/commit/5e072fc8c2adadba5ea610148be1c47800ba0cca/README.md#mods
- git.magicbean.dev/MagicBeanDev/Longshot/src/commit/5e072fc8c2adadba5ea610148be1c47800ba0cca/README.md#if-something-goes-wrong
- git.magicbean.dev/MagicBeanDev/Longshot/src/commit/5e072fc8c2adadba5ea610148be1c47800ba0cca/docs/saves.md
- git.magicbean.dev/MagicBeanDev/Longshot/src/commit/5e072fc8c2adadba5ea610148be1c47800ba0cca/LICENSE
- longshot.magicbean.dev/download
- longshot.magicbean.dev/tested-configurations/
COMMUNITY
Comments
Share a question, correction or experience with this project.