v0.1.0-beta

UnityVRMod v0.1.0-beta - First Public Beta Release!

I'm excited to announce the first public beta release of UnityVRMod! This has been a long journey of reverse-engineering, debugging, and development to create a stable and universal framework for bringing VR to non-VR Unity games.

This beta marks a huge milestone where the core functionality is stable, performant, and ready for wider testing. I'm looking forward to your feedback to help shape the future of this project.

Key Features in this Release

• Dual VR Backends:
  • OpenXR (Recommended): A modern, low-latency implementation for the best performance.
  • OpenVR (Fallback): A stable fallback for games that might have issues with the OpenXR backend.
• Broad Game Compatibility: Targets a wide range of Unity versions (approx. 5.6 - latest) for both Mono and IL2CPP runtimes.
• Advanced Configuration Overrides:
  • AssertedCameraOverrides: Force the mod to use a specific camera if the automatic detection isn't right for your game.
  • ScenePoseOverrides: Define a custom starting position and/or rotation for the VR rig on a per-scene basis, perfect for fixing awkward start points.
• Multi-Level Safe Mode: A critical tool for stability.
  • FastToggleOnly: Quickly pause rendering.
  • RigReinitOnToggle: A clean reset that destroys and recreates the VR rig.
  • FullVrReinitOnToggle: The most robust option, restarting the entire VR subsystem.
• Live Reloading: Many settings (World Scale, Eye Height) can be adjusted in-game without a restart using the temporary debug keybinds.

Known Issues

• OpenVR Safe Mode Instability: In the OpenVR build, using RigReinitOnToggle may cause the session to not recover.
  • Workaround: If you are using the OpenVR build, please set SafeModeLevel = FullVrReinitOnToggle in your config file. This is a high-priority bug that I will be addressing in the next sprint.
• Multi-Camera Games: In games with complex camera setups, the view may be incorrect. Using UnityExplorer's FreeCam feature is the recommended workaround.

How to Install

1. Make sure you have BepInEx 6 installed for your game.
2. Download the appropriate .zip file from the assets below for your game's runtime (Mono or IL2CPP) and preferred VR backend (OpenXR is recommended).
3. Extract the downloaded zip and merge its plugins folder with the one in your game's BepInEx directory.
4. Run the game once to generate the config file at BepInEx/config/com.newunitymodder.unityvrmod.cfg.

Thank you for testing this early version! Please report any bugs, issues, or suggestions on the GitHub Issues page.