Files

Wheel Wizard VR integration

The portable release uses Wheel Wizard revision 86618e7367df935d78401583136e492c6f00fa27 with the changes in wheelwizard-vr.patch.

The patch integrates the VR installation with Wheel Wizard's recomp services, including Retro Rewind updates, enabled-mod preparation, product validation and repair, and Retro-WFC payload management. The base-game selector remains available. Wheel Wizard settings stay beside the executable; runtime settings, Miis and Retro Rewind saves resolve to the same paths the VR game uses.

To reproduce the bundled launcher:

git clone https://github.com/TeamWheelWizard/WheelWizard.git
cd WheelWizard
git checkout 86618e7367df935d78401583136e492c6f00fa27
git apply ..\wheelwizard-vr.patch
dotnet publish WheelWizard/WheelWizard.csproj -c Release -r win-x64 --self-contained true `
  -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true `
  -p:EnableCompressionInSingleFile=true

Wheel Wizard is licensed under GPL-3.0. Its unmodified license is included in the portable archive.

Launcher/Build-Portable.ps1 now performs the pinned checkout, patch validation, self-contained launcher build, ROM-free bundle checks and manifest/checksum generation. Use a clean tagged Git checkout for releases; -AllowDirty is reserved for local development builds. The package workflow publishes only the portable archive and checksum when a tag is pushed.

Retro Rewind's Update action uses the full upstream update-and-reconcile workflow: asset-only changes do not force a rebuild, while changed compile inputs go through the VR setup's product repair. The setup release resolver and launcher-update notification use heurazy/mario-kart-wii-VR-port. A full runtime upgrade can still require the original PAL disc image configured in Settings.

Installed and portable layouts are supported, including a pack beside Install, external packs, and rebasing an internal pack after moving the portable directory. The local frontend stays in recomp mode; incompatible Dolphin video controls and the upstream recursive uninstaller cannot alter the shared VR installation.

See feature coverage and limitations. Run WheelWizard.exe --vr-diagnostics for a read-only JSON report of the resolved paths. Integration regression tests are included in the patch under WheelWizard.Test/Features/Recomp/LocalVrPathsTests.cs.

The patch also handles valid license renaming without a NAND Mii, preserving save identity and refusing empty slots. Launcher/Build-WheelWizard.ps1 reproduces the bundled launcher; the installer and portable package both include it.