• Installation
  • Easy installation (recommended)
  • Manual installation
• Requirements
• Comfort
• VR Controller Inputs
• Performance
  • Framerate
• Compatibility with other mods
• Reporting bugs / making requests
• Contributing
• Development Setup
• Special Thanks
• Help / Discuss development / Tell me about your day

• Get the Mod Manager from the Outer Wilds Mods website;
• Install NomaiVR from the mod list displayed in the application;
• If you can't get the mod manager to work, follow the instructions for manual installation.

• Install OWML;
• Download the latest NomaiVR release (Raicuparta.NomaiVR.zip);
• Extract the Raicuparta.NomaiVR directory to the OWML/Mods directory;
• Run OWML.Launcher.exe to start the game.

• The latest version of the game (1.0.7) installed (both Epic and Steam are supported);
• A VR Headset;
• VR controllers (not playable with a regular game controller);
• A VR-Ready PC;
• Steam and SteamVR installed (make sure SteamVR isn't running prior to running the game);
• Strong VR legs (both due to the nature of the game, and due to the glitchiness of this VR implementation).

Only recommended for people who aren't usually prone to VR sickness:

• A good portion of the game is spent spinning around in zero-g, which can be very disorienting;
• No comfort features like teleport and snap turning were implemented;
• Performance tends to not be that great, which can cause nausea;

There are some extra in-game tutorials for teaching you VR inputs, but some stuff doesn't have any tutorials yet.

• Your headset might not have any default bindings, in which case you'll have to make your own through SteamVR;
• You can interact with most stuff by aiming with the right-hand laser and pressing the interact button;
• Change tool modes by holding a tool on your right hand and touching it with your left hand;
• While piloting the ship, you can aim at and interact with stuff inside the ship (interact with the screens to equip that tool);
• Experiment with the controls. When in doubt, aim laser and press interact.

This game was not developed with VR in mind. It was also never a super lightweight game, and shoving VR down its throat isn't helping. You'll probably need to lower your quality settings to get acceptable performance.

Besides lowering the graphics in-game, try lowering the rendering rendering resolution in SteamVR's settings. Lowering resolution in-game has no effect.

Outer Wilds was originally locked to 60 FPS. To work around this, NomaiVR forces the game's physics refresh rate to match your VR headset's refresh rate. This can have a high impact on performance. Try lowering your refresh rate through SteamVR's settings (if your headset supports this) to get a more stable framerate.

If your headset doesn't support multiple refresh rates, you can override the game's physics refresh rate by editing NomaiVR's settings file (OWML/Mods/NomaiVR/config.json). Change overrideRefreshRate to whatever framerate you desire. Setting it to zero makes it follow your VR headset's refresh rate.

NomaiVR affects code in pretty much the whole game, and drastically changes things in ways that are sure to break other mods. If you are having issues, make sure you disable any other mods you might have installed.

See if your problem was already reported by searching for it in the issues list. If you find that someone else already reported the same issue, feel free to add to it by commenting (even if the issue is already closed). Otherwise, create a new issue (GitHub account required).

Look through the currently open issues and see if there's something you'd like to help with. If you find something you'd like to do, leave a comment on the issue. Fork the repo and make the changes you want. When you're done, open a PR from your fork to this one.

If you need help, leave a comment on the issue, or ask via Discord.

• Download the Outer Wilds Mod Manager and install it anywhere you like;
• Install OWML using the Mod Manager;
• Clone NomaiVR's source;
• Open the file NomaiVR/NomaiVR.csproj.user in your favorite text editor;
• Edit the entry <GameDir> to point to the directory where Outer Wilds is installed;
• Edit the entry <OwmlDir> to point to your OWML directory (it is installed inside the Mod Manager directory);
• Repeat this process for the file SteamVR/SteamVR.csproj.user;
• Open the project solution file NomaiVR.sln in Visual Studio;
• If needed, right click References in the Solution Explorer > Manage NuGet Packages > Update OWML to fix missing references;

After doing this, the project references should be working. When you build the solution, the dll and json files will be copied to [Mod Manager directory]/OWML/NomaiVR. If this process is successful, you should see the mod show up in the Mod Manager.

If for some reason none of this is working, you might have to set everything manually:

• To fix the references, right-click "References" in the Solution Explorer > "Add Reference", and add all the missing DLLs (references with yellow warning icon). You can find these DLLs in the game's directory (OuterWilds\OuterWilds_Data\Managed);
• If Visual Studio isn't able to automatically copy the files, you'll have to copy the built dlls manually to OWML.

• amazingalek, for making OWML and teaching me how to mod the game to begin with;
• TAImatem and misternebula, for improving the VR patch and for helpful discussions about the game's code;
• Logan Van Hoef, for assisting us with the game's code;
• Everyone over at the Outer Wilds Discord server for all the support;
• Mobius Digital for making a neat game.

Join the Outer Wilds Discord, we have a nice #modding channel where you can discuss all types of things.