Skip to content

Troubleshooting

Jump to bottom
dortamur edited this page Jan 27, 2025 · 21 revisions

Setup Tips

For most setups, use "OpenXR" in the UEVR Tool before injecting it if it is available for your headset

Quest / Pico

  • For best results use Virtual Desktop:
  • When using Oculus Link: Select "OpenXR" - but "OpenVR" works ok
  • When using Steam Link: Select "OpenVR" - do not use "OpenXR" as it is busted.
  • Of the two free options Oculus Link and OpenXR are better performance than Steam Link.

Index / PC SteamVR

  • Select "OpenVR" for UEVR Tools

Performance

VR is a performance hog. If your frame-rate is super-terrible, try:

  • Turn off "Global Illumination"!
  • Drop your VR render resolution down
  • Use DLSS and set it to "Performance" (for NVIDIA cards)
  • Check you're using the right one out of OpenVR/OpenXR ...let me know what works best for your setup!

Known Issues

There are a few issues that have not yet been resolved in the mod. These currently include:

  • Exiting to the main menu or Loading another save will crash the game
  • Pioneer Customisation UI is currently really trippy
  • Nobelisk throw is more of a dribble
  • Reviving a Pioneer does not work
  • Mouse emulation doesn't work if the game does not have focus

Troubleshooting Mod Setup

If the mod is not working, please follow these steps to verify you have correctly installed and set up both the UEVR Enhancements mod and the required UEVR tool and profile.

  • Check that SML is installed by running Satisfactory and verifying on the Main Menu that the Mod Loader is listed below the game version on the bottom left of the screen:

    If this is not shown, download the latest Satisfactory Mod Manager, install it, enable mods, and search for and install the "UEVR Enhancements" mod
  • Check that the "UEVR Enhancements" mod is installed by running Satisfactory and selecting "Mods" from the main menu. Verify that "UEVR Enhancements" is listed. Select it to access mod options.

  • Check that UEVR Tools has the new UEVR Profile installed for Satisfactory and the UEVR Enhancements mod.
    • Run UEVR Tools and select "Open Global Directory".
    • Verify that there is a folder called FactoryGameSteam-Win64-Shipping if you use the Steam version of Satisfactory or FactoryGameEGS-Win64-Shipping if you use the Epic Store version of Satisfactory
    • Open the FactoryGameSteam-Win64-Shipping/FactoryGameEGS-Win64-Shipping folder, and open the scripts folder. Check that it contains the file UEVREnhancements.lua

      If any of the above steps are not correct, then the UEVR Profile has not been installed properly. Check the Getting Started page and follow the instructions to download and import the correct profile into UEVR. Make sure the zip file name of the profile is correct and does not have any trailing characters!
  • Load a Satisfactory Save Game and verify that the "Ready for UEVR injection..." message is shown at the top-left (note: this may not show if you have disabled it in the mod settings)

  • Switch to the UEVR Tool and Inject into FactoryGameSteam-Win64-Shipping/FactoryGameEGS-Win64-Shipping. Click both left and right sticks in at the same time to open the UEVR configuration. Check that:
    • The UEVR version is version nightly 983 or newer
    • The menu includes a "LuaLoader" section
    • The Lua config shows "UEVREnhancements.lua" as a Known Script that is enabled

      If this is not the case, redownload and install UEVR version nightly 983 or newer, and import the UEVR profile as detailed on the Getting Started page

If you have any other issues, continue on to the next section...

Troubleshooting Other Issues FAQs

Windows Defender/Chrome/other virus scanner thinks UEVR is an evil virus!!1!

The UEVR Tool is a very recent open source tool that injects code into your other apps. Injecting code is what viruses do to do bad things, but in this case UEVR needs to do this to enable VR in games like Satisfactory that don't otherwise support it. You may need to tell your virus scanner to ignore/trust UEVR so it doesn't panic and hide it away from you.

Satisfactory says "Ready for UEVR Injection..." but it's not in VR

Did you set up UEVR, and "Inject" it into FactoryGame*-Win64-Shipping? If so and you're still having problems, check the UEVR site or the channels in their Flat2VR discord. Also try using it with other Unreal Engine games.

Wait - I can use UEVR for other games?

Well, yes - it's the "Unreal Engine Virtual Reality Tool". There's a lot of info about how to best configure it and how well it works for other games on the Flat2VR Discord. But the factory must grow...

Ok, I'm in VR but the controllers don't work!

If the mod is working (message "Ready for UEVR Injection..." shown before injecting UEVR), but controls aren't working, check that:

  • You are using version nightly 983 or newer of UEVR
  • You imported the correct Satisfactory profile for UEVR, and have not reset the settings

The in-game screens move about when I move my right controller!

This should no longer be an issue now - it's fixed! If you are still seeing this, check you have the correct Satisfactory profile for UEVR

Mouse Pointer doesn't work - or - I can't click on stuff - or - I click stuff to change settings, but when I close the screen the settings reset

This can happen when the Satisfactory game window doesn't have focus. Did you Alt-tab to Satisfactory Calculator on another screen? Make sure Satisfactory has the active focus.

Aieee! Smooth turn makes me want to hurl!

Snap Turn is now supported! Go into the Main Menu, select "Mods" then "UEVR Enhancements", and change the "VR Turning Style" to "Snap Turning". Adjust the angle of the snap turn using the "Snap Turn Angle" setting. The value here is multiplied by 5, so for a snap-turn of 45 degrees, set this to 9.

The controller buttons/sticks are doing different things than what is shown under the Controls page!

Have you tried custom controller bindings before trying the mod? Check the file %LocalAppData%\FactoryGame\Saved\Config\Windows\GameUserSettings.ini and make sure there are no mPlayerMappedKeys entries in there for Gamepad keys, as they will clash with the mod control bindings.

How do I do (snapping, rotate, other...)?

Most actions are available either in the right wrist panel for context actions, or the left wrist panel for information, equipment and quick-building. Many actions can also be done with the VR controllers - check the Controls page for how to use buttons, sticks and gestures.

One eye is black and/or there's lots of flickering!

Are you using Virtual Desktop to connect? If so, make sure you pick OpenXR in the UEVR Tools and set the OpenXR Runtime to VDXR in the Virtual Desktop Streamer config.

I can't see the aiming dot in some environments!

The aiming dot target defaults to "Red", albeit a white-hot red. You can change to a different colour through the mod options, which may be more visible for you.

I'm getting a double-render problem with things appearing twice

Are you using an older pre-RTX graphics card, such as a NVIDIA 1080? If so, try launching with the Direct X11 mode

The game keeps crashing!

This could be a number of things - here's some things to check:

  • If XR_APILAYER_MBUCCHIA_toolkit mentioned in the error dump, you're using OpenXR Toolkit, which causes this crash due to compatibility issues. Disable OpenXR Toolkit for Satisfactory.
  • If crashes on UEVR inject and you're using a Windows MR headset, try setting r.ShadowQuality 0 on the console (press ~ to access) before injecting. If this works, you can add this to %LocalAppData%\FactoryGame\Saved\Config\Windows\engine.ini under a [SystemSettings] heading
  • If you're using Vulkan rendering, try using DirectX12 or DirectX11 instead

I have some other problem or want to give feedback!

If you have any other issue not covered here, or want to give some feedback, please join the Flat2VR Discord and tell us there:

  • Step #1: Join Flat2VR discord: https://flat2vr.com/
  • Step #2: Join Satisfactory VR channels: #sf-join
  • Step #3: Check out the other Satisfactory VR channels, like #sf-general for general chat and feedback, #sf-support if you need some help, etc...
  • Step #4: Check out the other UEVR channels, like #ue-support - if you encounter graphical issues or problems injecting UEVR, this channel will most likely know more than in #sf-support
Clone this wiki locally