The aim of this mod is to enable VR mode in Outer Wilds, and eventually fix the problems that come with forcing VR in a game that's obviously not prepared for it.

While the game is playable at a surprisingly decent level, a lot of things range from mildly glitchy to completely broken. Expect nausea, low performance, flashing images, crashes, blue screens, house fires, big explosions visibe from space. Have a look at the currently open issues to have an idea of some of the stuff that needs fixing.

• Outer Wilds 1.0.5;
• Mod Loader (OWML);
• A VR Headset;
• VR controllers (if you want to play with a regular controller, use NomaiVR 0.5 instead of the latest);
• A VR-Ready PC (and even with that, you'll probably not have amazing performance);
• Steam and SteamVR installed and running prior to opening the game;
• Strong VR legs (both due to the nature of the game, and due to the glitchiness of this VR implementation).

Since most VR controllers have less buttons than a normal game controller, input mappings can't be one-to-one. This led to some creative use of motion controls in order to reduce the number of required buttons. The game will control a lot different than it did originally, and there won't be any tutorials teaching you how to play with these controls. Important things:

• Your headset might not have any default bindings, in which case you'll have to make your own through SteamVR;
• In SteamVR's settings you can see the default controls that I set up for the game;
• You can't change the control bindings in-game (they will always reset);
• You can interact with most stuff by aiming with the right-hand laser and pressing the "primary interaction" button;
• Right hand grip can be used to grab tools from the toolbelt;
• While holding a tool, press the "primary interaction" button to use the tool;
• 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.

• Download OWML;
• Follow OWML's instalation instructions;
• Download the latest NomaiVR release;
• Extract the NomaiVR directory to the OWML/Mods directory;
• Run OWML.Launcher.exe to start the game.
• Make sure the translator tool is set to "manual" in the settings;
• Disable button prompts in the settings (they will be wrong and annoying anyway);

• Create a shortcut to OWML.Launcher.exe and add the params -vrmode openvr (like in this image)
• Use the shortcut you just created to launch the game;

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.

Look at through currently open issues and see if there's something you'd like to help with. For investigation issues, you can help just by running the mod normally and testing stuff! For other issues, you'll need to follow the instructions in the Development section. Just fork the project and open a PR when you want to submit a change.

If your desired contribution doesn't fit one of the existing issues, create an issue first so we can discuss it.

• Install OWML in the game's directory (should be something like C:\Program Files\Epic Games\OuterWilds\OWML);
• If you already have NomaiVR installed, remove it from the OWML/Mods directory;
• Clone NomaiVR's source;
• Open the project solution file NomaiVR.sln in Visual Studio;
• On the Solution Explorer (usually the right side panel), under the project-name (NomaiVR), double click "Properties";
• Go to "Debug" and change (if needed) "Working Directory" to OWML's directory;
• Do the same thing for the SteamVR project (also inside NomaiVR's solution);
• If needed, right click References in the Solution Explorer > Manage NuGet Packages > Update OWML to fix missing references;
• In the top menu go to "Project" > "Unload Project", and then "Project" > "Reload Project".

After doing this, the project references should be working. When you build the solution, the dll and json files will be copied to OWML/NomaiVR, so you can start the game and test right away. Pressing "Start" on Visual Studio will start the game through OWML.

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

• To fix the build paths and automatically copy the files to OWML, edit the "Build Events" in the properties menu.
• To fix the references, right-click "References" in the Solution Explorer > "Add Reference", and add all the missing DLLs (references with yello warning icon). You can find these DLLs in the game's directory (OuterWilds\OuterWilds_Data\Managed).

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