Resurrected VRMod — Risk of Rain 2 VR mod, unofficial build by Blowntobytes

Play Risk of Rain 2 in virtual reality with motion controls, on the current Steam version of the game.

This is an unofficial, community-maintained rebuild of DrBibop's RoR2VRMod. The original mod stopped working after the game moved to a newer Unity engine; this build ports it to that engine, switches it to OpenXR, and fixes the things that broke along the way. All credit for the mod itself goes to DrBibop and the original contributors (see Credits). Released under the same MIT license.

• Source code: https://github.com/Blowntobytes/RoR2VRMod
• Original mod: https://github.com/DrBibop/RoR2VRMod
• Found a bug? Open an issue on the GitHub page above and attach your BepInEx/LogOutput.log.

Requirements

• Risk of Rain 2 (current Steam build).
• A PC VR headset with an OpenXR runtime: SteamVR (any SteamVR headset, Index, Vive, Pico/Quest via Steam Link, Virtual Desktop, ALVR), the Meta/Oculus PC runtime (Quest Link / Air Link), or Windows Mixed Reality.
• BepInExPack and HookGenPatcher (the mod manager installs these for you).

Which headsets work, and the one setting that matters

The mod does not care which headset you own — it asks Windows for whatever OpenXR runtime is currently active. So the only thing to get right is that the runtime matching your headset is the active one:

Only one runtime can be active at a time, so switching headsets means flipping this setting. Controller bindings are registered for Oculus Touch, Quest Touch Pro, Valve Index, HTC Vive, HP Reverb G2, WMR and the generic KHR profile, so the button layout below applies on all of them (Index/Beyond knuckles: the "grip" is the squeeze).

Turn off "Use Desktop Game Theatre while SteamVR is active" in the game's Steam properties.

Do not turn on the old "Use Oculus mode" config option — it is a leftover from the pre-OpenXR mod and does nothing in this build.

Installation

With r2modman / Thunderstore Mod Manager (recommended): install it from Thunderstore with the "Install with Mod Manager" button, then start the game with "Start modded". If you previously imported a pre-release zip of this mod as a local mod (or still have DrBibop's original VRMod installed), uninstall that entry first — two copies of the mod must never be installed together.

Manual: install BepInEx and HookGenPatcher first, then copy the plugins and patchers folders from the zip into your BepInEx folder.

The first launch copies the OpenXR native files into place; if the headset stays black the very first time, simply launch again. Pick up both controllers before the title screen so the runtime wakes them.

Controls

Bindings are built in (this build does not use the SteamVR binding editor). Button names follow the Oculus/Quest layout; on Index, Vive and WMR controllers the equivalent buttons are used.

Gameplay (right-handed; turn on "Left dominant hand" in the VR settings to swap the skill buttons)

Menus — the controllers act as a gamepad, and every on-screen prompt names the button that really does it (A is A, the trigger glyph means the trigger):

On the character select screen, A picks the highlighted survivor; the Ready button then becomes the highlighted control, so press A again (or move to it with the stick) to ready up. One press never does both.

VR settings

Open the in-game Settings and pick the VR tab (the same options are in BepInEx/config/VRMod.cfg, editable from the mod manager's Config editor). Notable options in this build:

• Auto Sprint — sprint automatically whenever you push the left stick, and re-engage on its own after anything cancels the sprint (firing a skill, taking a hit).
• Controller aim pitch — tilts the hands/aim up or down if your controllers report a different grip angle.
• Intro camera yaw — where the opening cutscene faces (default 180 so the ship arrives in front of you).
• Left dominant hand, snap turning, first person / motion controls, HUD scale and placement, and the other original options.

The camera always sits at the character's eye level with a seated (device) tracking origin; click the right stick to recenter after you sit down or turn your chair.

Known issues in this build

• Hand models are not shown inside menus (menus are navigated like a gamepad). Hands and weapons work normally in a run.
• The hands for the Seekers of the Storm and Alloyed Collective survivors are generated from the character model at runtime rather than hand-made, so they are functional rather than pretty. Their position and rotation can be tuned per survivor in the config.
• Bhaptics / Shockwave haptics suit support is still compiled in but has not been tested with this build.
• Character support from VRAPI (custom survivors with VR hands) is included unchanged and untested.

The mod's internal plugin ID is still com.DrBibop.VRMod, so other mods that depend on the VR mod or VRAPI keep working.

Multiplayer

Only VR players need the mod. You can play with vanilla (non-VR) players.

Building from source

The original Visual Studio project files are kept, but this build was produced with a self-contained, offline toolchain that needs only PowerShell 7 — see build-tools/README.md for the reference-assembly setup and the exact build commands. The packaged zip layout (manifest.json, README.md, CHANGELOG.md, icon.png, plugins/, patchers/) is the standard Thunderstore format.

Credits

DrBibop: original mod and patcher programmer, animator
MrPurple6411: patcher programmer
dotflare: 3D artist
Ncognito: 3D artist
eliotttate: original creator, code assist
HutchyBen: code assist
AmadeusMop: code assist
Daerst: fixed the biggest and oldest bug of the original mod
laila, HutchyBen, Skarl1n, Geb, Popzix, Terrorcotta211: controller support for the original mod
Blowntobytes: current-game-version port, OpenXR rebuild and maintenance of this fork
The ParentCamera.projectionMatrix = _childCamera.GetStereoProjectionMatrix(eye) stereo fix came from a community report.

Changelog

This package continues DrBibop's RoR2VRMod (MIT), whose own history ends at 2.18.x; its original changelog is kept in the source repository as CHANGELOG-original-DrBibop.md. Version numbers restart at 1.0.x for this package.

1.0.3

• README: revised install steps (r2modman profile code for dependencies, then Import local mod), controls and VR settings sections; Thunderstore page text now matches the GitHub README.

1.0.2

• README rewritten with step-by-step r2modman instructions (profile import code for the dependencies, then Import local mod).
• Source repository made public.

1.0.1 — first public release

(1.0.0 was consumed by a failed upload and was never published.)

Runs on the current game

• Ported to the game's current Unity engine and rebuilt on OpenXR (SteamVR, Meta/Oculus PC, Virtual Desktop VDXR and Windows Mixed Reality runtimes). Controller profiles for Oculus/Quest Touch, Touch Pro, Valve Index, HTC Vive, HP Reverb G2, WMR and the generic KHR profile.
• Seated (device) tracking origin with eye-level camera; right stick click recenters anywhere, including menus.
• Clean OpenXR shutdown on exit.

Survivors

• VR hands for the Seekers of the Storm and Alloyed Collective survivors (Seeker, Chef, False Son, Drifter, Operator) generated at runtime from the character model, posed from the bind pose so item pickups no longer bend them.
• Operator: gun attached to the left hand with tunable offsets; the docked drone leaves the right claw when thrown and returns when the skill is ready.
• Per-hand position and rotation offsets for every survivor in the config, shipped with in-headset tuned defaults.

Menus and HUD

• Every menu is navigated like a gamepad and every prompt shows the real button (A confirm, B back, triggers page left/right, grips switch settings tabs, Y pause).
• Seeker's lotus and meditation mini-game sit above the health bar (heights configurable).
• End-of-run report readable in VR, with configurable width and text size; left/right triggers page through players.
• Confirmation dialogs draw in front of the pause menu; pause menu draws in front of the report.
• Equipment slot icon, countdown and stock (including MUL-T's second slot) and the item strip initialise correctly on the hand HUD.
• Pickup notifications use the game's own duration.
• "Game window not focused" warning restored.

Intro cutscene

• Typed story text renders in the headset; seated height during the cutscene is configurable; the Skip prompt is visible from the start and only Y skips.
• Splash logo no longer drawn twice.

Settings

• VR tab in the game's settings: Auto Sprint, controller aim pitch, intro camera yaw, left dominant hand, snap turn, first person, HUD options.
• Config file: BepInEx/config/com.DrBibop.VRMod.cfg (plugin ID unchanged so mods depending on the VR mod keep working).