Back
GitHub
Decompilation ● ReleasedStandalone VRVersion v2.3.0
  • Quest 3

TPVR (Zelda: Twilight Princess VR)

The Legend of Zelda: Twilight Princess in first-person VR, standalone on Meta Quest 3. A VR mod for Dusklight, the native PC port built on the Twilight Princess decompilation: 6DoF tracking, physical sword swings and shield bashes, right-hand aiming, Midna's view for Wolf Link and an optional third-person mode. Bring your own disc dump.

  • Tracking
    Yes, 6DoF
  • Motion controls
    Yes, Physical sword swings and stabs, shield bash, right-hand item aiming
  • Rendering
    Yes, Single-pass stereo
  • Spatial audio
    Yes, Directional audio (v2.3.0)
Locomotion
  • Smooth Locomotion
  • Smooth Turn
  • Snap Turn
  • Motion Sword & Shield
Play modes
  • First person
  • Third person
  • Wolf Link (Midna's perspective)
  • Right-handed sword
Headsets
  • Quest 3
No Quest connected
1Step 1: Install Port APK

Checking browser support…

Verification

Install via QuestPorts on v2.3.0 · Quest 3 · 2 days ago · Game files not sent through the site

Installed by 9 people through QuestPorts

Step-by-Step Installation Guide

Install on Quest, in the card above, is the one-click USB install. These steps are the manual path (SideQuest or ADB).

Overview

TPVR brings The Legend of Zelda: Twilight Princess to VR, running standalone on Meta Quest 3: no PC, no cable, no streaming. It is a VR mod by JoeyAW for Dusklight, the native port built on the Twilight Princess decompilation, so the game runs natively rather than in an emulator.

You play Link in full stereoscopic 3D with 6DoF tracking and movement: swing the sword physically (vertical, left, right and stab register as separate attacks), bash with the shield and aim items with your right hand. Wolf Link uses Midna's perspective, and you can switch to a third-person camera or a right-handed sword mode. Single-pass stereo is on by default.

[!NOTE] No game assets are included. You need your own dump of Twilight Princess (any commercial GameCube or Wii disc except the Korean Wii release). Fan project, not affiliated with Nintendo or the Dusklight team. The author states the mod was written with AI-assisted code.


Prerequisites

  1. Meta Quest 3 with Developer Mode enabled (for sideloading).
  2. SideQuest (Advanced Installer) or ADB on a computer.
  3. Your own Twilight Princess disc dump as .iso or .rvz (how to dump).

Step-by-Step Installation

1. Install the APK

Download tpve-android-arm64.apk (v2.3.0) via 1-click on QuestPorts or from GitHub Releases and install it:

adb install -r tpve-android-arm64.apk

Alternative: install TPVR from SideQuest (app 62532); the SideQuest listing may lag behind the GitHub release.

[!WARNING] Updating to v2.3.0? Back up your save first. This release changed the Android signing key. The author tried to keep saves, but they may be lost, especially if you deny file access. If Android refuses to install over your old version, uninstall it (after backing up) and install again.

2. Copy your game dump

Put your .iso or .rvz anywhere easy to reach on the headset, for example the Download folder:

adb push your-tp-dump.rvz /sdcard/Download/

3. Play

In the headset: App Library → Unknown Sources → TPVR. On first launch, select your dump when asked, choose the Dusklight experience, then press Play.


Controls

Action Control
Sword Swing your sword hand (sword techniques and some scripted boss attacks use B)
Shield Bash with your shield hand
Aim items Right hand
Turning Smooth or snap (speed and increments in VR settings)
Dusklight menu Hold right stick + right trigger
Troubleshooting & Tips

The first boot can take a while (shader compilation): give it time before assuming it froze. If the game asks for your ROM again after an update, point it back to your .iso/.rvz. Some bosses and enemies with scripted attacks (e.g. Argorok, Beast Ganon, Morpheel) don't react to physical sword collision: press B or turn off physical sword swinging in the VR settings. If you updated from a version before v2.2.0, you may need to switch physical sword collision on manually. Players report it also runs on Quest 2, with some shader-compilation stutter and pop-in (not officially tested). Bug reports go to the TPVR Discord or GitHub, not to the Dusklight team.

Requirements SummaryStandalone VR

Original Game Required:
Requires your own original GameCube or Wii disc (any commercial release except the Korean Wii disc)About ↗
Asset Directory on Quest:
/sdcard/Any folder you choose for your .iso/.rvz (e.g. /sdcard/Download/)/
Required Files:
Base game assets
💬 Need Help or Mods? Community

Join the developer community for installation troubleshooting, high-resolution HD mod packs, and multiplayer sessions.