WiiCompiled OpenXR Preview 1

This is the first experimental VR release of Mario Kart Wii Recompile.

Highlights

• Experimental OpenXR rendering through Direct3D 12
• Immersive stereoscopic rendering during supported single-camera races
• 6DoF headset tracking
• GPU-only transfer into the OpenXR swapchains
• Menus and unsupported scenes appear on a head-locked virtual screen
• Desktop mirror remains available

You must provide your own legally dumped, clean and unmodified PAL copy of Mario Kart Wii:

• Game ID: RMCP01
• Accepted formats: ISO, GCM, GCZ, CISO, WBFS, WIA and RVZ
• Other regions and modified executables are rejected

Only the Windows Direct3D 12 OpenXR path is currently operational.

Installing the preview

WiiCompiled-Setup.exe is currently a command-line installer. Double-clicking it only displays information about Wheel Wizard.

1. Download and verify the installer

Download WiiCompiled-Setup.exe only from this GitHub release.

Current SHA-256:

293098bfc27e6dff789ec9887ce64af73f620b63cea663d2b512eb9e02bc2d68

To verify it in PowerShell:

(Get-FileHash .\WiiCompiled-Setup.exe -Algorithm SHA256).Hash

The installer is not code-signed yet, so Windows SmartScreen may display a warning. Only continue if it came from this repository and its checksum matches.

2. Validate your disc

Open PowerShell in the directory containing the installer and run:

.\WiiCompiled-Setup.exe --verify-inputs --game "C:\Games\Mario Kart Wii.iso"

Replace the example path with the location of your own disc image.

3. Install and compile the game

.\WiiCompiled-Setup.exe --silent --game "C:\Games\Mario Kart Wii.iso"

The default installation directory is:

%LOCALAPPDATA%\Programs\WiiCompiled

Translation and native compilation happen locally and can take a while. The compilation stage is normally the longest one.

When installation finishes, a wiicompiled (base) (beta) shortcut is created on the desktop and in the Start menu.

You can also launch it with:

& "$env:LOCALAPPDATA\Programs\WiiCompiled\WiiCompiled-Setup.exe" --launch-base

Enabling VR

Meta Quest with Virtual Desktop/VDXR

1. Start Virtual Desktop Streamer on the PC.
2. Select VDXR as the active OpenXR runtime.
3. Connect the headset through Virtual Desktop.
4. Launch WiiCompiled using its desktop or Start menu shortcut.
5. Press F10 while the game window has focus.
6. Enable OpenXR VR.
7. Close the game completely.
8. Launch it again while the headset and OpenXR runtime are active.

The OpenXR setting is read at startup, so restarting the game is required.

You can also enable it manually in:

%LOCALAPPDATA%\WiiCompiled\Config.toml

The relevant section is:

[vr]
enabled = true
required = false
render_scale = 1.0
world_units_per_meter = 500.0
hud_distance_meters = 2.0
stop_at_display_copy = true
skip_copy_clears = true

Keep required = false unless you want the game to stop with an error whenever OpenXR cannot start.

What to expect in VR

• Menus and loading screens appear on a head-locked 2D virtual screen.
• A supported single-camera race switches automatically to immersive stereo VR.
• Leaving the race returns to the virtual screen.
• Multiplayer and unclassified scenes currently remain on the virtual screen.
• OpenXR motion controllers are not implemented. Use a normal controller.
• Press F10 to configure controller mappings and graphics settings.