SOMA-VR (v1.06.2)

Release Notes:

• Fixed a bug at the shuttle chair seat at Upsilon's Shuttle Station, where if you interact with the chair before placing the Omni-Tool, flipping the switches and pressing the button, you'd be prevented from exiting the chair.
• Fixed a bug where sometimes, during scripted sequences/cutscenes, you couldn't enter your pause menu until it was over.
• Fixed a bug with the fire extinguisher when you first awake at Upsilon, where you can't turn when you grab it.
• Fixed some VR hint regressions and added some new VR hints.

Installation:

1. Download and extract the latest release of SOMA-VR in the "Releases" section.
2. Run the SOMA-VR setup.exe file.
3. Ensure that the path to your SOMA game directory, as well as the folder containing your user_settings.cfg folder are detected. If the setup isn't able to automatically detect those folders, you can manually search for them.
4. Press "Install". If done correctly, you should receive a confirmation prompt stating that the VR mod was successfully installed.
5. To launch SOMA VR, navigate to your SOMA game directory, and run the "LAUNCH-SOMA-VR.cmd" file. It should run as an administrator. Ensure that your VR headset and controllers are connected, and SteamVR or VD is running using the OpenXR or VDXR runtime.

NOTE:

• If it's your first time installing SOMA, please launch SOMA flatscreen first and complete the initial menu setup before installing the VR mod, as SOMA needs to generate the user_setting.cfg files.
• To use eye-tracking features (on a VR headset with eye-tracking), in your SteamVR application on your PC, open Settings > Steam Link > toggle "Share eye tracking data to other apps on this PC" on. If you're using Virtual Desktop, open Streaming > toggle "Forward tracking data to PC". Restart SOMA if it's already open.
• To disable reprojection, disable either "Motion Smoothing" (SteamVR), "Synchronous Spacewarp" (Virtual Desktop), "Asynchronous Spacewarp" (Meta Link), or "Frame Interpolation" and "Frame Buffering" (Pico Connect).

Troubleshooting:

• If your game immediately crashes upon injection, ensure that SteamVR is using OpenXR as its runtime.
• If your SOMA main menu looks out of place, try re-centering your camera using its designated keybind.
• If your cursor won't appear in SOMA's main menu when using your VR controllers, ensure that your SOMA game window is focused on your PC.

For any other in-game related issues, please upload "hpl3vr.log" from your game's root directory, and "hpl.log" from your C:\Users[YOUR_NAME]\Documents\My Games\Soma\Main. Include a description of what the issue is, where this issue occurred, what VR headset and controllers you're using, and your operating system.

If you crash, please also include the crash log found in your SOMA game root directory.

SOMA-VR (v1.06.1)

Release Notes:

• Added a new VR setting under VIDEO - "DESKTOP MIRROR". If toggled on, your VR view will now show on the SOMA desktop game window, instead of a black screen. If you experience FPS drops with setting on, you can toggle it off in the VR settings.
• Fixed a bug with the tool chip bin at Upsilon, where grabbing a Tool Chip could sometimes fail to grab.
• Fixed a bug where grabbing one readable in one hand, then grabbing another readable with another hand, would cause a grip issue with the second readable, where it'd require two grips instead of one.
• Fixed a bug with the initial Omni-Tool pickup at Upsilon, where it could require two grip inputs to grab instead of one.
• Fixed a bug with early WAU flower interactions, where, sometimes, using your index finger to interact with the WAU flower would sometimes not register.

Installation:

1. Download and extract the latest release of SOMA-VR in the "Releases" section.
2. Run the SOMA-VR setup.exe file.
3. Ensure that the path to your SOMA game directory, as well as the folder containing your user_settings.cfg folder are detected. If the setup isn't able to automatically detect those folders, you can manually search for them.
4. Press "Install". If done correctly, you should receive a confirmation prompt stating that the VR mod was successfully installed.
5. To launch SOMA VR, navigate to your SOMA game directory, and run the "LAUNCH-SOMA-VR.cmd" file. It should run as an administrator. Ensure that your VR headset and controllers are connected, and SteamVR or VD is running using the OpenXR or VDXR runtime.

NOTE:

• If it's your first time installing SOMA, please launch SOMA flatscreen first and complete the initial menu setup before installing the VR mod, as SOMA needs to generate the user_setting.cfg files.
• To use eye-tracking features (on a VR headset with eye-tracking), in your SteamVR application on your PC, open Settings > Steam Link > toggle "Share eye tracking data to other apps on this PC" on. If you're using Virtual Desktop, open Streaming > toggle "Forward tracking data to PC". Restart SOMA if it's already open.
• To disable reprojection, disable either "Motion Smoothing" (SteamVR), "Synchronous Spacewarp" (Virtual Desktop), "Asynchronous Spacewarp" (Meta Link), or "Frame Interpolation" and "Frame Buffering" (Pico Connect).

Troubleshooting:

• If your game immediately crashes upon injection, ensure that SteamVR is using OpenXR as its runtime.
• If your SOMA main menu looks out of place, try re-centering your camera using its designated keybind.
• If your cursor won't appear in SOMA's main menu when using your VR controllers, ensure that your SOMA game window is focused on your PC.

For any other in-game related issues, please upload "hpl3vr.log" from your game's root directory, and "hpl.log" from your C:\Users[YOUR_NAME]\Documents\My Games\Soma\Main. Include a description of what the issue is, where this issue occurred, what VR headset and controllers you're using, and your operating system.

If you crash, please also include the crash log found in your SOMA game root directory.

SOMA-VR (v1.0.6)

Release Notes:

• Added a new VR setting under GAMEPLAY - "VR HINTS".
• Added custom contextual VR interaction and control hints.
• Added manual power pump handling with proper collision at Theta Tunnels.
• Improved performance by optimising scripts to increase CPU headroom.
• Fixed a bug with socketed key-item acquisition, where grabbing the item would sometimes cause it to fall to the ground instead of being gripped.
• Fixed a bug with chip acquisition, where grabbing a chip, like a Tool Chip, sometimes wouldn't register.
• Fixed a bug with socketed Omni-Tool acquisition, where grabbing the Omni-Tool when disconnected sometimes wouldn't register.

Installation:

1. Download and extract the latest release of SOMA-VR in the "Releases" section.
2. Run the SOMA-VR setup.exe file.
3. Ensure that the path to your SOMA game directory, as well as the folder containing your user_settings.cfg folder are detected. If the setup isn't able to automatically detect those folders, you can manually search for them.
4. Press "Install". If done correctly, you should receive a confirmation prompt stating that the VR mod was successfully installed.
5. To launch SOMA VR, navigate to your SOMA game directory, and run the "LAUNCH-SOMA-VR.cmd" file. It should run as an administrator. Ensure that your VR headset and controllers are connected, and SteamVR or VD is running using the OpenXR or VDXR runtime.

NOTE:

• If it's your first time installing SOMA, please launch SOMA flatscreen first and complete the initial menu setup before installing the VR mod, as SOMA needs to generate the user_setting.cfg files.
• To use eye-tracking features (on a VR headset with eye-tracking), in your SteamVR application on your PC, open Settings > Steam Link > toggle "Share eye tracking data to other apps on this PC" on. If you're using Virtual Desktop, open Streaming > toggle "Forward tracking data to PC". Restart SOMA if it's already open.
• To disable reprojection, disable either "Motion Smoothing" (SteamVR), "Synchronous Spacewarp" (Virtual Desktop), "Asynchronous Spacewarp" (Meta Link), or "Frame Interpolation" and "Frame Buffering" (Pico Connect).

Troubleshooting:

• If your game immediately crashes upon injection, ensure that SteamVR is using OpenXR as its runtime.
• If your SOMA main menu looks out of place, try re-centering your camera using its designated keybind.
• If your cursor won't appear in SOMA's main menu when using your VR controllers, ensure that your SOMA game window is focused on your PC.

For any other in-game related issues, please upload "hpl3vr.log" from your game's root directory, and "hpl.log" from your C:\Users[YOUR_NAME]\Documents\My Games\Soma\Main. Include a description of what the issue is, where this issue occurred, what VR headset and controllers you're using, and your operating system.

If you crash, please also include the crash log found in your SOMA game root directory.

SOMA-VR (v1.0.5)

Release Notes:

• Added authored hand grip poses for all key-items, Omni-Tool, and Simon's phone when retrieved from their respective holsters.
• Added a new VR setting under EYE-TRACKING - "DYNAMIC FOVEATED RENDERING" with three presets: Quality, Balanced, and Performance [NVIDIA GPU ONLY, REQUIRES A VR HEADSET WITH EYE TRACKING].
• Added a new VR setting under VIDEO - "TEXTURE BUDGET BOOST." This should make textures load in quicker when toggled on.
• Added reprojection [toggled via motion smoothing].
• Improved finger tracking on non Steam Frame controllers, like Valve Index Knuckles.
• Fixed a major stuttering issue when moving and turning.
• Made answering Simon's phone easier and more responsive.
• Added compatibility for SOMA's Epic Games and GOG versions.

Installation:

1. Download and extract the latest release of SOMA-VR in the "Releases" section.
2. Run the SOMA-VR setup.exe file.
3. Ensure that the path to your SOMA game directory, as well as the folder containing your user_settings.cfg folder are detected. If the setup isn't able to automatically detect those folders, you can manually search for them.
4. Press "Install". If done correctly, you should receive a confirmation prompt stating that the VR mod was successfully installed.
5. To launch SOMA VR, navigate to your SOMA game directory, and run the "LAUNCH-SOMA-VR.cmd" file. It should run as an administrator. Ensure that your VR headset and controllers are connected, and SteamVR or VD is running using the OpenXR or VDXR runtime.

NOTE:

• If it's your first time installing SOMA, please launch SOMA flatscreen first and complete the initial menu setup before installing the VR mod, as SOMA needs to generate the user_setting.cfg files.
• To use eye-tracking features (on a VR headset with eye-tracking), in your SteamVR application on your PC, open Settings > Steam Link > toggle "Share eye tracking data to other apps on this PC" on. If you're using Virtual Desktop, open Streaming > toggle "Forward tracking data to PC". Restart SOMA if it's already open.

Troubleshooting:

• If your game immediately crashes upon injection, ensure that SteamVR is using OpenXR as its runtime.
• If your SOMA main menu looks out of place, try re-centering your camera using its designated keybind.
• If your cursor won't appear in SOMA's main menu when using your VR controllers, ensure that your SOMA game window is focused on your PC.

For any other in-game related issues, please upload "hpl3vr.log" from your game's root directory, and "hpl.log" from your C:\Users[YOUR_NAME]\Documents\My Games\Soma\Main. Include a description of what the issue is, where this issue occurred, what VR headset and controllers you're using, and your operating system.

If you crash, please also include the crash log found in your SOMA game root directory.

SOMA-VR (v1.04.1)

Release Notes:

• Fixed an MSAA bug where SOMA VR would launch with a black screen.
• Fixed an MSAA bug where loading a save would cause the menu to only appear in one eye, and the mod would fail to transition to stereoscopic 3D gameplay.

Thank you, Ingle, for testing the diagnostic builds to fix this issue!

Installation:

1. Download and extract the latest release of SOMA-VR in the "Releases" section.
2. Run the SOMA-VR setup.exe file.
3. Ensure that the path to your SOMA game directory, as well as the folder containing your user_settings.cfg folder are detected. If the setup isn't able to automatically detect those folders, you can manually search for them.
4. Press "Install". If done correctly, you should receive a confirmation prompt stating that the VR mod was successfully installed.
5. To launch SOMA VR, navigate to your SOMA game directory, and run the "LAUNCH-SOMA-VR.cmd" file. It should run as an administrator. Ensure that your VR headset and controllers are connected, and SteamVR or VD is running using the OpenXR or VDXR runtime.

NOTE:

• If it's your first time installing SOMA, please launch SOMA flatscreen first and complete the initial menu setup before installing the VR mod, as SOMA needs to generate the user_setting.cfg files.
• To use eye-tracking features (on a VR headset with eye-tracking), in your SteamVR application on your PC, open Settings > Steam Link > toggle "Share eye tracking data to other apps on this PC" on. If you're using Virtual Desktop, open Streaming > toggle "Forward tracking data to PC". Restart SOMA if it's already open.

Troubleshooting:

• If your game immediately crashes upon injection, ensure that SteamVR is using OpenXR as its runtime.
• If your SOMA main menu looks out of place, try re-centering your camera using its designated keybind.
• If your cursor won't appear in SOMA's main menu when using your VR controllers, ensure that your SOMA game window is focused on your PC.

For any other in-game related issues, please upload "hpl3vr.log" from your game's root directory, and "hpl.log" from your C:\Users[YOUR_NAME]\Documents\My Games\Soma\Main. Include a description of what the issue is, where this issue occurred, what VR headset and controllers you're using, and your operating system.

If you crash, please also include the crash log found in your SOMA game root directory.

SOMA-VR (v1.0.4)

Release Notes:

• Added Steam Frame compatibility (additional keybinds, finger tracking, eye-tracking).
• Fixed SOMA VR Eye-Tracking features and special interactions.
• Fixed a bug with lighting/shadows rendering in only one eye with certain light sources.
• Fixed multi-monitor setups causing menu cropping bugs.
• Fixed a bug with SOMA sometimes slightly adjusting resolution.
• Fixed a vertex weight painting issue with Simon's human hand model.
• Fixed missing haptics for control panel switches outside Omicron.
• Fixed issues with finger tracking finger articulation and poses.
• Added two new VR settings options - "RESET FINGER TRACKING" and a "FINGER TRACKING" toggle, for those with VR controllers with finger tracking, but would rather use the standard grip + trigger layout for controllers without finger tracking.
• Made grabbing connectors and plugs more consistent and responsive.
• Made grabbing readables, like pictures on walls, etc, more consistent and responsive.

Installation:

1. Download and extract the latest release of SOMA-VR in the "Releases" section.
2. Run the SOMA-VR setup.exe file.
3. Ensure that the path to your SOMA game directory, as well as the folder containing your user_settings.cfg folder are detected. If the setup isn't able to automatically detect those folders, you can manually search for them.
4. Press "Install". If done correctly, you should receive a confirmation prompt stating that the VR mod was successfully installed.
5. To launch SOMA VR, navigate to your SOMA game directory, and run the "LAUNCH-SOMA-VR.cmd" file. It should run as an administrator. Ensure that your VR headset and controllers are connected, and SteamVR or VD is running using the OpenXR or VDXR runtime.

NOTE:

• If it's your first time installing SOMA, please launch SOMA flatscreen first and complete the initial menu setup before installing the VR mod, as SOMA needs to generate the user_setting.cfg files.
• To use eye-tracking features (on a VR headset with eye-tracking), in your SteamVR application on your PC, open Settings > Steam Link > toggle "Share eye tracking data to other apps on this PC" on. If you're using Virtual Desktop, open Streaming > toggle "Forward tracking data to PC". Restart SOMA if it's already open.

Troubleshooting:

• If your game immediately crashes upon injection, ensure that SteamVR is using OpenXR as its runtime.
• If your SOMA main menu looks out of place, try re-centering your camera using its designated keybind.
• If your cursor won't appear in SOMA's main menu when using your VR controllers, ensure that your SOMA game window is focused on your PC.

For any other in-game related issues, please upload "hpl3vr.log" from your game's root directory, and "hpl.log" from your C:\Users[YOUR_NAME]\Documents\My Games\Soma\Main. Include a description of what the issue is, where this issue occurred, what VR headset and controllers you're using, and your operating system.

If you crash, please also include the crash log found in your SOMA game root directory.

SOMA-VR (v1.0.3)

Release Notes:

• Improved performance by optimising CPU overhead when performing expensive calculations, scans and queries.
• Fixed a bug with the ARK object usage at TAU.
• Fixed a 2D menu cropping bug with ultrawide monitors.
• Fixed a bug with WAU flower and WAU manual/physical interactions.
• Fixed a bug with the ARK launch at Phi.
• Fixed a failed 3D > 2D transition bug.
• Made drawer and hinged door grabbing more responsive.
• Fixed an issue with grabbing items in drawers.
• Added a new VR settings option - "DOUBLE-TAP SPRINT".
• Updated launcher to automatically detect and configure user_settings.cfg files.
• Streamlined installation process by using an installer instead of manually placing the files.

Installation:

1. Download and extract the latest release of SOMA-VR in the "Releases" section.
2. Run the SOMA-VR setup.exe file.
3. Ensure that the path to your SOMA game directory, as well as the folder containing your user_settings.cfg folder are detected. If the setup isn't able to automatically detect those folders, you can manually search for them.
4. Press "Install". If done correctly, you should receive a confirmation prompt stating that the VR mod was successfully installed.
5. To launch SOMA VR, navigate to your SOMA game directory, and run the "LAUNCH-SOMA-VR.cmd" file. It should run as an administrator. Ensure that your VR headset and controllers are connected, and SteamVR or VD is running using the OpenXR or VDXR runtime.

NOTE:

• If it's your first time installing SOMA, please launch SOMA flatscreen first and complete the initial menu setup before installing the VR mod, as SOMA needs to generate the user_setting.cfg files.

Troubleshooting:

• If your game immediately crashes upon injection, ensure that SteamVR is using OpenXR as its runtime.

For any other in-game related issues, please upload "hpl3vr.log" from your game's root directory, and "hpl.log" from your C:\Users[YOUR_NAME]\Documents\My Games\Soma\Main. Include a description of what the issue is, where this issue occurred, what VR headset and controllers you're using, and your operating system.

If you crash, please also include the crash log found in your SOMA game root directory.

SOMA-VR (v1.0.2)

Release Notes:

• Fixed a save-load 2D > 3D handoff transition bug.
• Adjusted Tracer Fluid consumption/usage sensitivity.
• Added a new VR comfort option - "HIDE HEAD AND HAND BOBBING".
• Fixed grabbing bugs with special interactables on walls, like pictures, notes, etc.
• Fixed a bug where interacting with a door, drawer, etc, with your free hand, while holding a prop in your other hand, would cause the prop to fall.
• Fixed a bug with drawer movement.
• Added manual/physical interactions with tablets. I don't know how I missed this.
• [EXPERIMENTAL] added support for other versions of SOMA, like GOG or Epic Games. Use the "Launch-SOMA-VR-Experimental.cmd" file if you're not using the Steam version of SOMA.

Installation:

1. Download and extract the latest release of SOMA-VR in the "Releases" section. If you have issues extracting the folder, use 7-ZIP to extract.
2. Extract contents of the "SOMA-VR-vx.xx" to the root of your SOMA game directory (where Soma.exe is located). Replace all files if prompted. I recommend creating a backup of your existing SOMA game folder.
3. [FIRST TIME INSTALLATION ONLY] Navigate to your user settings config file (C:\Users[YOUR_NAME]\Documents\My Games\Soma\Main), open the "YOURNAME_ID_user_settings.cfg", and make these changes:

• Engine LimitFPS="false"
• FullScreen="false"

4. Start SteamVR and ensure that your headset and controllers are connected. Ensure that SteamVR is using OpenXR as its runtime.
5. To launch SOMA VR, run "Launch-SOMA-VR.cmd" from your root game directory. If prompted with an error stating "access is denied," or "elevation required," or anything in that regard, run that same file as an administrator.

Troubleshooting:

• If your game immediately crashes upon injection, ensure that SteamVR is using OpenXR as its runtime.
• If your game still immediately crashes, navigate to your user settings config file (C:\Users[YOUR_NAME]\Documents\My Games\Soma\Main), open the "YOURNAME_ID_user_settings.cfg" file, and ensure that your screen's width and height is set to your monitor's resolution (E.G, Width = 2560, Height = 1440 for 2560x1440).
• If your game's menu looks weirdly cropped, ensure that your game is running in windowed mode instead of fullscreen.

For any other in-game related issues, please upload "hpl3vr.log" from your game's root directory, and "hpl.log" from your C:\Users[YOUR_NAME]\Documents\My Games\Soma\Main. Include a description of what the issue is, where this issue occurred, what VR headset and controllers you're using, and your operating system.

If you crash, please also include the crash log found in your SOMA game root directory.

SOMA-VR (v1.0.1)

Release Notes:

• Fixed an issue where keyboard menu inputs would break 3D-2D transitions and stereo rendering.
• Fixed an issue where opening the pause menu in the opening cutscene after starting a new game incorrectly caused the cutscene to transition to 3D.
• Fixed an issue where changing graphical settings in VR caused the menu to stretch and crop.
• Potentially fixed an issue with multi-monitor setups causing the main menu to be incorrectly cropped.
• Potentially fixed an issue where the main menu would sometimes start upside-down when using Virtual Desktop.
• SOMA VR launcher now force terminates any existing instance of SOMA. Added another file to force close SOMA.

Installation:

1. Download and extract the latest release of SOMA-VR in the "Releases" section. If you have issues extracting the folder, use 7-ZIP to extract.
2. Extract contents of the "SOMA-VR-vx.xx" to the root of your SOMA game directory (where Soma.exe is located). Replace all files if prompted. I recommend creating a backup of your existing SOMA game folder.
3. [FIRST TIME INSTALLATION ONLY] Navigate to your user settings config file (C:\Users[YOUR_NAME]\Documents\My Games\Soma\Main), open the "YOURNAME_ID_user_settings.cfg", and make these changes:

• Engine LimitFPS="false"
• FullScreen="false"

4. Start SteamVR and ensure that your headset and controllers are connected. Ensure that SteamVR is using OpenXR as its runtime.
5. To launch SOMA VR, run "Launch-SOMA-VR.cmd" from your root game directory. If prompted with an error stating "access is denied," or "elevation required," or anything in that regard, run that same file as an administrator.

Troubleshooting:

• If your game immediately crashes upon injection, ensure that SteamVR is using OpenXR as its runtime.
• If your game still immediately crashes, navigate to your user settings config file (C:\Users[YOUR_NAME]\Documents\My Games\Soma\Main), open the "YOURNAME_ID_user_settings.cfg" file, and ensure that your screen's width and height is set to your monitor's resolution (E.G, Width = 2560, Height = 1440 for 2560x1440).
• If your game's menu looks weirdly cropped, ensure that your game is running in windowed mode instead of fullscreen.

For any other in-game related issues, please upload "hpl3vr.log" from your game's root directory, and "hpl.log" from your C:\Users[YOUR_NAME]\Documents\My Games\Soma\Main. Include a description of what the issue is, where this issue occurred, what VR headset and controllers you're using, and your operating system.

If you crash, please also include the crash log found in your SOMA game root directory.

SOMA-VR (v1.0.0)

Release Notes:

Initial release. Bugs are to be expected.

Installation:

1. Download and extract the latest release of SOMA-VR in the "Releases" section. If you have issues extracting the folder, use 7-ZIP to extract.
2. Extract contents of the "SOMA-VR-vx.xx" to the root of your SOMA game directory (where Soma.exe is located). Replace all files if prompted. I recommend creating a backup of your existing SOMA game folder.
3. [FIRST TIME INSTALLATION ONLY] Navigate to your user settings config file (C:\Users[YOUR_NAME]\Documents\My Games\Soma\Main), open the "YOURNAME_ID_user_settings.cfg", and make these changes:

• Engine LimitFPS="false"
• FullScreen="false"

4. Start SteamVR and ensure that your headset and controllers are connected. Ensure that SteamVR is using OpenXR as its runtime.
5. To launch SOMA VR, run "Launch-SOMA-VR.cmd" from your root game directory. If prompted with an error stating "access is denied," or "elevation required," or anything in that regard, run that same file as an administrator.

Troubleshooting:

• If your game immediately crashes upon injection, ensure that SteamVR is using OpenXR as its runtime.
• If your game still immediately crashes, navigate to your user settings config file (C:\Users[YOUR_NAME]\Documents\My Games\Soma\Main), open the "YOURNAME_ID_user_settings.cfg" file, and ensure that your screen's width and height is set to your monitor's resolution (E.G, Width = 2560, Height = 1440 for 2560x1440).
• If your game's menu looks weirdly cropped, ensure that your game is running in windowed mode instead of fullscreen.

For any other in-game related issues, please upload "hpl3vr.log" from your game's root directory, and "hpl.log" from your C:\Users[YOUR_NAME]\Documents\My Games\Soma\Main. Include a description of what the issue is, where this issue occurred, what VR headset and controllers you're using, and your operating system.

If you crash, please also include the crash log found in your SOMA game root directory.