- Runs standalone on Meta Quest 3. No PC, no Link cable, no streaming.
- Installed by sideloading (SideQuest). The full walkthrough is in QUEST.md.
- You need your own copy of the game (ROM). No game assets are included.
- This is a Quest port of Ship of Harkinian VR by ShinyWindow. For the PC VR version (DirectX 11, SteamVR), use his repo.
Get the latest APK from this repo's Releases page.
For problems with the Quest version, open an issue on this repo. Ship of Harkinian's own Discord and website are for the main (non-VR) game. Please keep in mind that we do not condone piracy.
You need your own copy of Ocarina of Time: a ROM file (you can check it's a supported version at ship.equipment).
1. Get ready (one time)
- Turn on Developer Mode: create a free account at developers.meta.com, then in the Meta Horizon phone app go to Devices > Headset settings > Developer mode and switch it on. Restart the Quest.
- Install SideQuest (Advanced Installer) on your computer: sidequestvr.com.
- Connect the Quest to your computer with a USB cable, put it on, and choose Allow when it asks about USB debugging.
2. Install the game
- Download the latest
Quest3-OOT-*.apkfrom Releases. - In SideQuest, click Install APK (top right) and pick that file.
3. Copy your ROM to the Quest
- In SideQuest, click the folder icon (top bar), open the Download folder, and drag your ROM into it. Any file name works. (More detail: How to copy files to your Quest.)
4. Play
- In the headset: App Library > Unknown Sources > Quest 3: OOT.
- When it asks, check "allow access to edit files on device", then go back to the game.
- The first launch shows loading dots for 1 to 2 minutes. It isn't frozen: it finds your ROM by itself and builds the game from it. This only happens once. (If it can't find a ROM, a setup screen in the headset tells you what to do.)
That's it. Want 3D rooms and HD textures? See Bonuses.
You'll do this for your ROM, and again for the bonus texture pack.
- Connect the Quest to your computer with a USB-C cable and put the headset on. If it asks to allow access to data, choose Allow.
- Open SideQuest on your computer and wait for the green dot (top left) that means the Quest is connected.
- Click the folder icon in SideQuest's top bar ("manage files on the headset"). You're now looking at the Quest's storage.
- Open the destination folder by double-clicking it:
- your ROM goes in Download;
- texture pack files go in SOHVR, then mods (the SOHVR folder appears after the game's first launch).
- Drag the files from your computer into the SideQuest window and wait for the copy to finish.
On Windows you can also use File Explorer instead of SideQuest: the Quest shows up as Quest 3 > Internal shared storage, with the same folders.
Once the game is installed and running, two free upgrades make it look much better in VR. Both come from one download, Djipi's 3DS Experience, which isn't included in this project (it's Djipi's work, made from Nintendo's textures).
Get the pack (for either bonus):
-
Download it: click here to download
djipi_s_3ds_experience_tot_fix.zip(655 MB). Or, on the GameBanana page, scroll all the way down to the Files section and click Manual Download underdjipi_s_3ds_experience_tot_fix.zip(the second file, not the small "Art Plus Link" one):
-
Unzip it on your computer (Mac: double-click it; Windows: right-click, Extract All). You get a folder of 37 files named
Djipi's 3DE - 01 ...toDjipi's 3DE - Z .... These are the files you copy to the Quest below.
Some places in Ocarina of Time (Link's house, the Market and its back alleys, the shops, the Temple of Time entrance) are flat pre-rendered pictures with the characters walking in front of them. That works on a TV but not in VR, so in these rooms you see green backdrops instead of walls. This bonus replaces them with real 3D rooms.
- Copy the room files to the Quest (see How to copy files to your Quest): into SOHVR, then mods, drag these four files (just the files, no subfolders):
Djipi's 3DE - 26 Background 3DSDjipi's 3DE - 27 Background TexturesDjipi's 3DE - 32 Background Full 3D (OPTIONAL)Djipi's 3DE - 33 Background Full 3D Textures (OPTIONAL)
- Launch the game (restart it if it was running). That's it: mods are on by default, so there's nothing to switch on. The easiest place to check it worked is Link's house, which is now a real 3D room instead of a green backdrop.
Still seeing green backdrops, or a room looks wrong? Check that files 32 and 33 are directly in SOHVR/mods (not in a subfolder) and that Settings > Mod Menu > Enable Mods is on (open settings with the hamburger button). The rooms are tested with the whole pack installed; if something looks off with only these four files, add the rest (Bonus 2).
Replaces the whole game's N64 textures and models with Ocarina of Time 3D's HD versions: characters, enemies, items, dungeons and Hyrule Field.
- Copy the whole pack. Drag all 37 files into SOHVR/mods, the same way (the four room files from Bonus 1 are part of it, so this covers both bonuses).
- Launch the game (restart it if it was running).
- Let it optimize. About 30 seconds after you start playing with a new pack, the game begins compressing it for the Quest in the background, which takes about 3 minutes. You can keep playing; the progress is in VR Settings > Performance > Texture Pack.
- Restart once. When it says "restart the game to use it", quit and launch again. From then on it uses about 4x less memory and loads faster.
Keep Djipi's original files in the mods folder: the game still reads a few textures from them. If you add, remove or update pack files later, it notices and re-optimizes by itself.
Known issue with the current pack version: some players report a crash in the Chamber of Sages cutscene with the latest Djipi update (there's a workaround in the GameBanana comments).
Optional files you can leave out: 24/25 (Majora's Mask style chests), Original N64 HUD Mod (keeps the N64 HUD), Z - Crescent Moon Addon. If you use a custom Link model, delete 02 Link's Textures.
What I use on my Quest, on top of the install and both bonuses:
- VR Settings > Comfort & Movement: turning set to Smooth.
- VR Settings > Performance > Stereo Render Divisor: 2 (the default; see below).
- Enhancements > Graphics > Increase Actor Draw Distance: 5x.
- Left-handed mode: off (right hand is the sword hand).
- VR Settings > VR Inputs (selector profile): left grip = Z-target, right grip = shield (R), Y = pause (Start), left stick click = L.
- Extra Settings Menu Button: None (the hamburger always opens settings).
- VR Settings > Items & Archery: Landing Target on, Flight Path Line off.
What the Stereo Render Divisor does: at 1, the game redraws the 3D world for every frame the headset shows (72 per second), so animation and movement are fully smooth. At 2, it redraws the world every other frame, and the headset fills the frames in between by shifting the last image to match your head. Head tracking stays at full speed either way, but the world itself animates at half rate, and the game needs about half the processing power. The default is 2, which keeps busy areas smooth. Try 1 if you want fully smooth world animation and it holds up in the areas you play.
| Action | Control |
|---|---|
| Move | Left stick |
| Turn | Right stick (smooth turning; snap turning is in the settings) |
| Sword | Swing your sword hand |
| Shield | Raise your shield hand |
| Choose an item | Click the right stick, flick your hand toward an item, release |
| Use an item | Trigger |
| Slingshot / bow | Bring your free hand to the weapon, squeeze the trigger, pull back, release. A ring shows where the shot will land (target and flight line toggles: VR Settings > Items & Archery). |
| Grab and throw a Deku Nut | Grip near the nut in front of your chest, then throw |
| Pause, save, equip | Left stick click (right stick click in left-handed mode) |
| Settings menu (in the headset) | Left menu button (a second button can be added in Settings > Controls); aim with a controller, trigger to click |
Everything VR-specific (left-handed mode, turning, hand and HUD placement, comfort, performance) is under VR Settings in the in-headset menu.
Ship of Harkinian (SOH) is built atop a custom library dubbed libultraship (LUS). Back in the N64 days, there was an SDK distributed to developers named libultra; LUS is designed to mimic the functionality of libultra on modern hardware. In addition, we are dependant on the source code provided by the OOT decompilation project.
Ship of Harkinian VR adds a VR renderer and motion controls on top. This Quest port runs that VR renderer natively on the headset:
- OpenXR on OpenGL ES (Meta's Android runtime) instead of Direct3D 11 and OpenVR.
- Single-pass stereo (both eyes rendered in one pass with GL_OVR_multiview2), plus an optimized software renderer, holding 72 fps in Hyrule Field.
- Quest-first features: physical slingshot and bow with a landing marker, 3D item compass, in-headset settings menu, whole-view scene fades, hand-locked held items.
- On-device texture-pack optimization: HD packs are compressed to ASTC (the Quest GPU's native format) automatically.
The full list is in CHANGES.md.
In order for the game to function, you will require a legally acquired ROM for Ocarina of Time. Click here to check the compatibility of your specific rom. Any copyrighted assets are extracted from the ROM and reformatted as an archive file which the code uses.
Custom assets are packed in .otr / .o2r archive files. To use custom assets on the Quest, place them in the SOHVR/mods folder on the headset (with SideQuest's file manager) and turn on Settings > Mod Menu > Enable Mods.
| Mod | Where to get it | What it does |
|---|---|---|
| Djipi's 3DS Experience (all 37 files, including the optional ones) | GameBanana, main download djipi_s_3ds_experience_tot_fix.zip |
Replaces the N64 textures, models and backgrounds with Ocarina of Time 3D's HD look. The "Background Full 3D" files turn the pre-rendered rooms (Link's house, the Market back streets, shops) into real 3D rooms, which matters a lot in VR. |
How to install it: see Bonuses.
Settings I use with it: Enhancements > Graphics > Increase Actor Draw Distance set to 5x (you can see across Hyrule Field) and VR Settings > Performance > Stereo Render Divisor at 2.
It isn't included in this project (it's Djipi's work, made from Nintendo's textures), which is why you download it yourself.
If you're interested in creating and/or packing your own custom asset files, check out the following tools:
The Android/Quest project is in Android/. Clone with submodules (git clone --recursive), install JDK 17 and the Android SDK and NDK, then run ./gradlew assembleDebug in Android/. For the desktop builds, see the building instructions.
The VR layer lives in libultraship/src/fast/vr_openxr.cpp; the VR gameplay features are in soh/soh/Enhancements/vr-combat/.
More detailed documentation can be found in the 'docs' directory, including the aforementioned building instructions.
- HarbourMasters for Ship of Harkinian.
- ShinyWindow for Ship of Harkinian VR.
- linkzenic for the Android port of Ship of Harkinian.
- Djipi for the 3DS Experience texture pack.
- Quest 3 standalone port by ChocoTorp.
This is a fan project, not affiliated with or endorsed by Nintendo. The Legend of Zelda and Ocarina of Time are trademarks of Nintendo.