Repository navigation
Releases
Test build: experimental VR (2026-11-14)
Test build — experimental VR (SteamVR / OpenXR), Windows x64. Not an official release. Built by this repo's Windows test workflow from commit 2216194 (main with PR #15).
Important
No game files or game code are included. You need your own legally obtained copy of The Legend of Zelda: Skyward Sword HD (v1.0.0 or v1.0.1). The launcher builds the game code on your machine from your files.
New since test-vr-2026-11-10
- Sky Recomp v2.2: game v1.0.1 and Archipelago support from upstream.
- Swings hit on their own: a fast swing of the blade hits by itself, in the direction you swung (VR Options > Swings Hit on Their Own, Swing Speed to Hit). No slash trail, and the view doesn't lean with Link's slashes.
- Right stick up / down is the D-pad's up / down.
- Boss-key puzzle: the view switches to the game's close-up of the key and the lock while you turn it.
- Any sword or shield goes on its controller, not only the Goddess Sword; the sheathed sword and the shield on his back aren't drawn in 1st person.
Fixed since test-vr-2026-11-10
- Slicing only at the tip: sword hits now follow the blade as it's drawn, hilt to tip.
- Sword and shield falling back to the game's animation: pieces of them were being learned as items of their own. If you used an earlier build, delete
vr_held_models.txtnext toskyrecomp.exe(it is relearned). - Hands the wrong way round (the sword in the left hand) after spawning or with arms crossed.
- The view left behind by a side hop or backflip while Z-targeting.
- 1st person works right after a save loads; shadows stay behind the Gear menu and the map; doors lock only when the game says so.
How to use
- Unzip anywhere and run
skyrecomp.exe. - Pick your game files folder and set them up.
- Turn on VR Options > Enable VR Mode with SteamVR running.
Requirements: Windows 10/11 x64, Vulkan 1.3, an AVX2 CPU.
Third-party components keep their licences; the bundled Khronos OpenXR loader is under Apache 2.0 (LICENSE-OpenXR.txt).
quest-packager-v0.2.0-pre.1
Standalone personal APK builders. Windows: run
Skyrecomp-VR APK Builder.exe; no extraction is required. Linux:
make Skyrecomp-VR-APK-Builder-x86_64.AppImage executable and run it.
Test pre-release. The builders make a personal APK that contains the
game runtime and your own recompiled game code, and install it with
your game data on a Quest 3 / 3S over USB. The app itself has not been
run on a headset yet: expect it not to boot, and please report what
adb logcat -s SkyRecomp shows. No game files are included.
Test build: experimental VR (2026-11-10)
Test build — experimental VR (SteamVR / OpenXR), Windows x64. Not an official release. Built by this repo's Windows test workflow from commit 762ec68 (main with PR #9).
Important
No game files or game code are included. You need your own legally obtained copy of The Legend of Zelda: Skyward Sword HD (v1.0.0). The launcher builds the game code on your machine from your files.
Fixed since test-vr-2026-11-07
- Missing room props in 1st person (e.g. furniture vanishing in the Knight Academy dormitory): this wasn't culling, but the code that hides Link's own body mistaking props for parts of Link (PR #9).
- Enemies no longer vanish: enemies that came close are no longer mistaken for Link and hidden.
New since test-vr-2026-11-07
- The Beetle: it launches from the right controller along where it points, and sits with its bracelet on your wrist. While it flies, the view switches to the game's own camera following it, and returns to 1st person when it's caught.
Everything from the previous test build is still included: hands and held items on the controllers, sword hits from your blade, controller aiming and the Slingshot, Link's body hidden, and culling that follows the headset.
How to use
- Unzip anywhere and run
skyrecomp.exe. - Pick your game files folder and set them up.
- Turn on VR Options > Enable VR Mode with SteamVR running.
Requirements: Windows 10/11 x64, Vulkan 1.3, an AVX2 CPU.
Third-party components keep their licences; the bundled Khronos OpenXR loader is under Apache 2.0 (LICENSE-OpenXR.txt).
Test build: experimental VR (2026-11-07)
Test build — experimental VR (SteamVR / OpenXR), Windows x64. Not an official release. Built by this repo's Windows test workflow from commit 858f70b (branch vr-body-cull: PR #6 and its follow-up PR #7).
Important
No game files or game code are included. You need your own legally obtained copy of The Legend of Zelda: Skyward Sword HD (v1.0.0). The launcher builds the game code on your machine from your files.
What's new for VR
- Hands and held items: in 1st person, Link's hands, sword, shield and Slingshot stay on your controllers.
- Sword hits: a slash hits where the blade in your hand goes, using the game's own sword colliders. Z-targeting no longer steers it.
- Controller aiming: aimed items and a new Slingshot system point where the right controller points, with a 3D marker where the seed will land.
- Hidden body: Link's own body, hair and small pieces stay hidden in 1st person.
- Culling: objects are culled against what the headset sees, and their draw distance is measured along where you look.
See docs/vr.md and the CHANGELOG.
How to use
- Unzip anywhere and run
skyrecomp.exe. - Pick your game files folder and set them up.
- Turn on VR Options > Enable VR Mode with SteamVR running.
Requirements: Windows 10/11 x64, Vulkan 1.3, an AVX2 CPU.
Third-party components keep their licences; the bundled Khronos OpenXR loader is under Apache 2.0 (LICENSE-OpenXR.txt).