Longshot

Longshot is a Hookshot-derived static recompilation tool for native Windows and Linux, with launcher-managed local builds, Vulkan graphics and mods.

Latest release: v3.0.0-rc.3 Pre-releaseLast checked:

The overview

The launcher obtains the Builder and translates supported code to C on the user’s PC. Current documentation separates stable and nightly channels and covers installation, hardware, saves and mods. Download the launcher from the project’s site; release attachments are Builder components.

Introduction sources checked

· README 9dd4132

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.
  • Current requirements: 64-bit Windows 10/11, or x86-64 Linux with glibc 2.35+. AVX2 is no longer required. Older pinned AppImage notes below describe their historical release and may have stricter requirements.
  • 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 the Stable channel for normal use. Current documentation has Stable and Nightly channels; older RC packages remain historical releases. Nightly builds 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 Switch2Fan 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

Where can I download Longshot?

Use the upstream release links on this page. MagicBeanDev provides the files; Switch2Fan does not host binaries or game data.

Which Longshot package should I use?

Choose a package for Windows, Linux (native x86-64) that matches your CPU architecture. Read the package-selection table and the upstream requirements before installing. A launcher, development dependency and runtime may be separate files.

Is the newest listed release guaranteed to be stable?

No. Check the prerelease label and the upstream notes. Releases marked with a developer caution do not expose direct file downloads. An hourly metadata check is not a game compatibility test.

Sources & review

Reviewed · README 5e072fc

Search by project, maintainer or platform. Use Tab to select a result.