⚠️ Note: This mod is a work in progress. Please do not expect a polished or bug-free experience.

SubmersedVR is a mod designed to modernize and enhance the VR support for Subnautica, making it a more immersive VR experience.

If you prefer the original VR mode and want to play with a traditional Xbox or PS4 controller, we recommend using the Subnautica VR Enhancements Mod instead.

1. Subnautica Installation: Install the latest version of Subnautica from Steam or Epic Games Store.
   • Beta Branches (legacy/experimental): Not supported. Switch to the default branch.
   • Microsoft Store Version: Outdated and incompatible.
   • Epic Games Version with AirLink: Additional setup is required. Refer to this issue comment for detailed instructions.
2. BepInEx: Download and set up BepInEx for Subnautica.
3. Incompatibilities: Ensure the following mods are NOT installed:
   • Subnautica VR Enhancements Mod
   • Motion Controls Mod

1. Download the Mod:

   • Get the latest release from GitHub Releases.
   • Important: Download the file named SubmersedVR_VERSION.zip, NOT the source code.

2. Extract Files:

   • Extract the contents of the zip file into your Subnautica installation directory (e.g., C:\SteamLibrary\steamapps\common\Subnautica).
   • To find your game directory:
     • Steam: Right-click the game > Properties > Local Files > Browse.

3. Important Notes:

   • If files are not copied correctly, the mod might load partially, and your controllers may not function due to missing bindings.
   • ⚠️ Mod Managers Warning: Tools like Vortex may skip important steps and cause a broken installation.

4. Launch the Game:

   • Start Subnautica in SteamVR. The Oculus Runtime is not supported.
   • For Oculus Rift or Link users:
     • Add -vrmode openvr to the game's launch options. Learn how to set launch options.
     • Start SteamVR manually before launching the game.

This game and mod work well on Linux in VR as well!

You need to follow the above steps, just like you would on Windows, and add an additional launch option so that Wine loads the winhttp DLL from the mod loader. You need to prepend WINEDLLOVERRIDES="winhttp=n,b" to the command in the SteamVR launch options, e.g. WINEDLLOVERRIDES="winhttp=n,b" %command%.

I tested it myself with WiVRn on a Quest 3 with xrizer.

For WiVRn, you need some additional options too. In my case, the full command line is:

WINEDLLOVERRIDES="winhttp=n,b" PRESSURE_VESSEL_FILESYSTEMS_RW=$XDG_RUNTIME_DIR/wivrn/comp_ipc %command% -vrmode openvr

The only issue I noticed is that the trigger doesn't always activate the interact action. But you can press the A button for that instead. Maybe I can get around to fixing it.

Feel free to give it a try and report your findings on the LVRA DB Entry of the game.

For developers looking to contribute or customize the mod, follow these steps:

• Install the .NET SDK.

1. Clone the repository and update the SubnauticaDir property in SubmersedVR/SubmersedVR.csproj to your Subnautica installation path.
2. Run the following commands:

   dotnet restore
   dotnet build

3. The mod will build and install automatically into the configured Subnautica directory.

1. Install the C# Extension.
2. (Optional) Enable decompilation support for better debugging:
   • Add this setting to omnisharp.json:

     {
       "RoslynExtensionsOptions": {
         "EnableDecompilationSupport": true
       }
     }

• Open the solution file SubmersedVR/SubmersedVR.csproj and build the project.

• Verify the following:

  • You are using the latest Subnautica version from Steam.
  • Beta branches (legacy or experimental) are NOT selected.
  • Mod managers like Vortex are not causing an incomplete installation.

• Known good setup as of 07/12/2024

  • BepInEx for Subnautica v5.4.23-payload.2.3.0
  • AirLink or SteamVR is running with the -vrmode openvr launch option.
  • Launch the game from the SteamVR dashboard.

If you encounter a bug, please report it on the GitHub Issues page. To help us identify and resolve the issue efficiently, please include the following:

1. Detailed Description:

   • Describe the issue clearly. Include what you expected to happen and what actually happened.

2. Steps to Reproduce:

   • Provide a step-by-step guide on how to reproduce the issue.

3. Logs:

   • Attach the logs from your game. You can find the logs at:
     • Steam:
       C:\Program Files (x86)\Steam\steamapps\common\Subnautica\BepInEx\LogOutput.log
       • (If your Steam library is located elsewhere, navigate to your Subnautica installation folder using Properties > Local Files > Browse and find the LogOutput.log file in the BepInEx folder.)
     • Epic Games:
       Locate your Subnautica folder, then find BepInEx\LogOutput.log.

• Check the GitHub Milestones for a roadmap.
• If you have a new idea, feel free to suggest it via the Issues page.

• Yes! A fork of this mod is available for Below Zero, maintained by @jbusfield.
  • Check out the Below Zero fork releases.

• ihatetn931: Original developer of the SN1MC mod, which served as a foundation for this project.
• IWhoI: Creator of Subnautica VR Enhancements Mod, whose fixes and features inspired this mod.
• Raicuparta: Developer of other VR mods whose work guided many improvements in SubmersedVR.

This project is licensed under the MIT License. See the LICENSE file for more details.