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.

Latest release: v3.0.0Last checked:

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

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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 releases

Minimum and recommended hardware

Swipe horizontally to compare all columns.

Longshot — Minimum and recommended hardware
ComponentMinimum estimateRecommended in README
CPU6 cores: Ryzen 5 2600 / Core i5-8400Ryzen 5 5600 / Core i5-12400 or newer
GPUVulkan 1.3: GTX 1060 6 GB / GTX 1650, RX 5500 XT, Arc A380RTX 3060 / 4060, RX 6600 XT / 6700 XT, Arc A750; check known issues
Memory16 GB RAM, 4 GB VRAM; memory pressure remains possible16 GB+ RAM and 8 GB+ VRAM; leave room for the OS
StorageAbout 60 GB free during buildingSSD, about 60 GB free
View source

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.

Longshot — Reported compatibility and open issues
Area / deviceUpstream report
Kokiri Forest and basic playGameplay, sound, controls and saves reported working.
Hyrule Field, towns and dungeonsPlayers reached them; lighting, shadows, crashes and freezes remain open.
NVIDIAThe most-tested GPU family in the README.
AMDSeveral cards reported; device-loss issues remain. Some RX 6000 Windows GPUs use a compute fallback by default.
Intel / no mesh shadersIntel reports are limited, with black screens/crashes. Compute fallback can be slower and omit draws.
Linux / SteamOSAppImage reported on several distributions; AMD and Steam Deck issues remain. AVX2 still applies.
View source

Controls and everyday settings

Longshot — Controls and everyday settings
ActionREADME guidance
Open settingsF1 always works; default shortcuts also include Insert / Esc. Gamepad: Home or Select + Start.
Move / cameraWASD moves; arrows or IJKL turn the camera. Default E selects New Game.
Menu tabsGraphics, Audio, Gameplay, Controls and Debug. Q/E or controller shoulders switch tabs.
Shader preparationMost is recommended. All adds predicted pipelines and takes longer, without guaranteeing fewer stutters.
View source

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.

Longshot — Saves, settings and mods
ItemLocation / rule
Windows savesuser/ inside the game folder. Back it up before updates.
Linux saves~/.local/share/longshot; migration from earlier user/ layouts is described upstream.
Settings / logslongshot_options.ini and longshot_env.txt in the game folder; logs/longshot_log.txt. cache/ holds GPU-specific caches.
RomFS modsmods/<name>/romfs/...; a - or _ prefix disables a mod. If files conflict, the last folder name alphabetically wins.
View source

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.

Longshot — Troubleshooting before reporting a bug
SymptomFirst checks from the README
Unsupported versionCheck the game update and build e0f3ccfa; changing graphics settings cannot fix a wrong dump version.
New-area stutterFirst encounters still compile shaders. Keep shader preparation enabled and check whether later visits improve.
Device lost / closesUpdate the GPU driver and preserve logs. AMD and Intel have documented issues; record the card and driver.
Skipped shader preparationCheck cache/longshot_prepare_skipped. Upstream explains rebuilding with Prepare shaders now, or removing that marker to prepare at next start.
Wrong or missing surfacesLook for longshot_damaged_files.txt and consult the dump-integrity and mesh-fallback notes.
View source

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

COMMUNITY

Comments

Share a question, correction or experience with this project.

Search by game, project or maintainer. Use Tab to choose a result.