CyberpunkVR Port

A 6-DoF VR mod for Cyberpunk 2077, built as a RED4ext plugin — there is no dxgi.dll proxy any more. CyberpunkVR_Stereo drives OpenXR head tracking, real stereo and the in-headset overlay; CyberpunkVR_Hands drives a full-body VR avatar with motion-controlled hands; and a set of CET / redscript mods add VR weapon aiming, motion melee, hand-to-holster equipping, a VR-friendly HUD and more. Everything is configured from an in-headset F10 overlay.

PS VR2 community fork: https://github.com/satyaloka93/cyberpunk-vr-port
Upstream project: https://github.com/dariulone/cyberpunk-vr-port

PS VR2 fork. The psvr2-tweaks branch and 0.1.1-psvr2.* releases add the tested SteamVR/OpenXR Sense-controller path, PS VR2 launcher presets, UEVR-style Triangle D-pad shifting, dual-role Create/menu handling, safe overlay pacing, and expanded VR HUD alignment. Current release: 0.1.1-psvr2.2. See docs/PSVR2-CONTROLS.txt.

⚠️ Experimental community mod. Not affiliated with CD PROJEKT RED. Use at your own risk and keep backups of your saves.

Features

• Real stereo, not reprojection. The second eye is an actual engine view — a render-to-texture camera on the player entity that runs the frame graph for its own eye, from its own position, with its own projection. It falls back to mono automatically whenever that view has nothing fresh to give (menus, loading).
• OpenXR head tracking injected into the REDengine render path, with the submitted frustum matching the one the engine actually rendered on both axes, plus world-scale / IPD controls.
• The game HUD in both eyes — the engine's own HUD composite is ported shader-for-shader for the second eye, and placed at a finite distance so icons fuse instead of splitting.
• Full-body VR avatar (VRIK) — body under the HMD, arm-length calibration, leg IK, real-life squat. Hands are with the controllers.
• Decoupled VR weapon aim — bullets follow the real weapon muzzle, not the camera; optional barrel dot in both eyes, scope-zoom aware.
• Collimated reflex sights — the reticle is placed by angle along the sight's own optical axis, so it stays on the bore instead of sliding across the glass when you look at the sight from the side.
• VR motion melee — real swings trigger the game's native melee along the blade (native damage/reaction/stamina).
• Hand-to-holster equip/unequip on a grip squeeze — immersive (by visual holster) or simple (fixed weapon slots).
• VR smoking — cigarette and lighter as real props, with a captured finger grip, a hands-free mouth anchor and the game's own FX and audio.
• VR controller mapping merged into XInput: full-forward = sprint, full-down = crouch, snap or smooth turn, HMD/hand-relative locomotion, D-pad chord.
• VR HUD with per-element placement & scale, world-map head-lock, CAS sharpening, and DLSS/NGX handling (the second view gets its own upscaler viewport automatically).
• In-headset F10 overlay with tabbed, live, persisted settings.
• SteamVR (OpenVR) runtime supported alongside OpenXR; pre-launch resolution selector; quiet-by-default logging with a DEBUG toggle in the launcher.

See docs/ for engineering notes, and docs/RELEASE-0.1.0.txt for how the stereo path is actually built.

Requirements

• Cyberpunk 2077 (PC, 2.31).
• Cyber Engine Tweaks (1.37.1 tested on Cyberpunk 2.31)
• RED4ext
• ArchiveXL
• TweakXL
• redscript
• Codeware (1.20 or newer — older builds fail script compilation)
• Visual Holsters (Automatic Clothes Swap)
• Visible Bullets (Projectile Restoration)
• Equipment-EX
• Nova Optics
• HUDitor v1.1.0 — aligns and resizes supported standard HUD widgets for VR
• Input Loader — required by current HUDitor releases

Install RED4ext, CET and redscript first (the usual Nexus dependencies). Mod Settings is recommended for rebinding HUDitor and selecting press/hold behavior.

Optional PS VR2 adaptive triggers and grip haptics

The PS VR2 path can additionally reuse Enhanced DualSense Support's gameplay profiles through the PSVR2Toolkit community fork. This optional feature adds three dependencies:

• Enhanced DualSense Support
• Native Settings UI
• PSVR2Toolkit Cyberpunk DSX Bridge and its matching Sense-tuned driver

DSX and Enhanced DualSense Support's bundled UDP client are not used. Bridge v0.2.0 combines weapon-aware recoil with stereo audio-derived haptics for explosions, impacts, vehicles, ambience, and other gameplay. Follow docs/PSVR2-ADAPTIVE-TRIGGERS.md for installation, UDP-autostart settings, launcher-DLL compatibility, intensity tuning, recovery, and troubleshooting.

Installation (drop-in)

Download the archive from the PS VR2 fork releases and extract its contents into your Cyberpunk 2077 game root (the folder that contains bin\, r6\, red4ext\). The files land as:

red4ext\plugins\CyberpunkVR_Stereo\CyberpunkVR_Stereo.dll     # the VR plugin: OpenXR, stereo, overlay
red4ext\plugins\CyberpunkVR_Stereo\CyberpunkVR_Sight*.dxil    # sight shaders, loaded by name at PSO swap
red4ext\plugins\CyberpunkVR_Hands\CyberpunkVR_Hands.dll       # native plugin (avatar/hands, weapon aim, shared bridge)
bin\x64\plugins\cyber_engine_tweaks\mods\CyberpunkVRPort_*\   # CET mods: Stereo (VRCAM select), HUD, Holster, VRIK, Weapon, WorldMap
r6\scripts\CyberpunkVRPort_*\                                 # redscript: HUD, Holster, Melee, NoAnims, WeaponUp, WorldMap

Then install and configure HUDitor using docs/HUDITOR-VR-SETUP.md. HUDitor defaults to F7, which conflicts with this port's HMD recenter; rebind its editor before play.

Finally, start your OpenXR runtime first, and launch the game. When updating, preserve red4ext\plugins\CyberpunkVR_Stereo\vrik_calibration.ini, HUDitor's persistency.json, and the VR HUD's hud_layout.ini.

There is no dxgi.dll any more — this is a RED4ext plugin. Anything else that proxies dxgi (R.E.A.L. VR, for one) must be out of bin\x64 or the two fight over the same engine hooks; scripts\deploy_stereo.ps1 moves one aside for you.

Keep only one .dll in each red4ext\plugins\CyberpunkVR_* folder. RED4ext loads every DLL it finds there, so a renamed backup beside the real build loads as a second copy of the plugin and the two fight over the same hooks.

From a source tree, install with:

cmake --build build --config Release --target cyberpunkvrport_stereo
pwsh scripts\deploy_stereo.ps1 -GameRoot "<game root>"

Experimental Wabbajack automation

The wabbajack/ definition builds a portable Mod Organizer 2 profile from 11 pinned direct sources and four pinned Nexus files. The complete list compiled, downloaded from an empty cache, installed with zero verification errors, and opened as a recognized Cyberpunk profile under Wabbajack 4.2.1.4. The current artifact remains a validation build until a real MO2-launched VR regression test and GUI metadata build are complete; see wabbajack/README.md.

Controls

For PS VR2 installation, SteamVR binding steps, the complete Sense control map, and troubleshooting, read docs/PSVR2-CONTROLS.txt. The same file is included at the root of the release archive. Optional adaptive triggers and grip haptics are documented separately in docs/PSVR2-ADAPTIVE-TRIGGERS.md.

VR controller input is merged into the native CP2077 gamepad, so the in-game "Controller" key bindings apply. Default VR mapping:

Input	Action
Left stick	Walk / strafe — push fully forward = sprint
Right stick X	Turn camera (snap or smooth)
Right stick fully down	Crouch (R3)
Right trigger / Left trigger	Fire / Aim
Right grip	Hand-to-holster equip / unequip; melee power modifier
Left grip	Crouch (shoulder)
A / B	Jump / Dodge
X / Y	Reload·interact / Weapon switch
Right thumb click	Crouch (R3)
Triangle capacitive touch + R3	Tap: Start/system-pause menu · hold ≥0.5 s: Back/in-game menu (PSVR2 fallback)
Menu/Create/Options	Tap: Start/system-pause menu · hold ≥0.5 s: Back/in-game menu
Swing a melee weapon	VR motion melee (native attack along the blade)

D-pad shifting. Touch/hold the left thumbrest, then pick the direction with the right stick — up / down / left / right. On PSVR2 through SteamVR, Triangle capacitive touch is the left-thumbrest modifier, matching UEVR's PSVR2 LEFT_TOUCH behavior. The right stick is removed from camera/snap turn while shifting. The game's D-pad input is emitted, but the final merged right-stick axes are suppressed for the whole shift hold so the external scanner target remains head-look controlled. D-pad shifting does not move HUD elements. Use HUDitor for supported standard widgets and F10 → HUD for VR-specific groups and dynamic panels. Left-stick click remains a fallback modifier; release it without choosing a direction to emit normal L3/sprint.

Buttons follow each runtime's interaction profile (Touch / PSVR2 Sense through SteamVR / Index / Vive / WMR). Edit physical OpenXR bindings in SteamVR under Settings → Controllers → Manage Controller Bindings; edit Cyberpunk actions in Settings → Key Bindings → Controller. On PSVR2, Square/Triangle map to X/Y and Cross/Circle map to A/B through SteamVR's Oculus Touch compatibility profile. SteamVR's automatic Oculus-to-PSVR2 remapper omits the generated Menu/System paths. A manual SteamVR binding can map left Create directly to the application's Sense Create / Options (SystemButton) action. It follows UEVR's dual-role timing: a quick press/release emits XInput Start for Cyberpunk's system/pause menu; holding it for at least 0.5 seconds emits XInput Back for the in-game menu. Despite the action's internal name, neither gesture opens SteamVR's reserved dashboard. The same tap/hold behavior is available from the Triangle-touch + R3 fallback. A bare R3 remains crouch.

Hotkeys:

• F7 — recenter HMD
• F10 / Insert — open the in-headset settings overlay
• HUDitor editor — rebind its default F7 to another unused keyboard key; see docs/HUDITOR-VR-SETUP.md

In-headset overlay (F10)

Five tabs, live, and saved to vrport.ini — nothing here needs a restart.

• General — world scale, IPD scale, stereo separation, VR menu FOV and quad size, motion prediction, reuse-last-clean-frame, pose pair-lock, and the head offset (X right / Y forward / Z up).
• Controls — decoupled weapon aim and its laser dot, locomotion source (Game / HMD / left hand / right hand), snap turn and angle, immersive holsters.
• Stereo — the second eye itself: which eye VRCAM is sent to, how stale its last frame may get before the submit falls back to mono, the HUD composite, and the live counters that say whether the second view is producing, being captured and reaching the headset.
• VRIK — start/stop tracking, IK calibration (reach scale, height, elbow swing/pole, wrist offset), diagnostics.
• HUD — per-element X / Y / scale for every VR HUD group, including a dedicated Center overlays row for scanner, quickhack, interaction, and game-info popups. Use HUDitor first for supported standard-widget base placement.

The launcher (before the game starts) picks the render resolution and carries a DEBUG tick-box that arms every diagnostic probe at once. Leave it off for play: it is for diagnosis and it costs both frame time and a very large log.

Mod components

Component	Type	Purpose
CyberpunkVR_Stereo.dll	RED4ext plugin	OpenXR head tracking, the second engine view, HUD composite, sight shaders, F10 overlay, XInput merge
CyberpunkVR_Hands.dll	RED4ext plugin	Full-body avatar / hand IK, weapon-aim orientation override, smoking poses, shared-memory bridge
CyberpunkVRPort_Stereo	CET	Enables the VRCAM component the launcher picked
CyberpunkVRPort_VRIK	CET	Starts hand tracking, bridges calibration
CyberpunkVRPort_Weapon	CET	Decoupled weapon aim + VR motion-melee detection
CyberpunkVRPort_Holster	CET + reds	Hand-to-holster equip/unequip (immersive / simple)
CyberpunkVRPort_Smoking	CET + reds	Cigarette / lighter props, FX, audio, auto-puff
CyberpunkVRPort_HUD	CET + reds	VR HUD layout
CyberpunkVRPort_WorldMap	CET + reds	World-map head-lock
CyberpunkVRPort_Melee	reds	Native melee along the blade segment
CyberpunkVRPort_WeaponUp	reds	Stops auto-lower / auto-unequip of drawn weapons
CyberpunkVRPort_NoAnims	reds	Disables VR-fighting animations (keeps gameplay systems)

Logs

• Cyberpunk 2077\bin\x64\cyberpunkvrport.log — the plugin's own log, and the right file for a bug report. Quiet by default; tick DEBUG in the launcher for per-frame diagnostics.
• Cyberpunk 2077\red4ext\logs\ — script validation and plugin load errors. If redscript compilation fails, every redscript mod is off, not just the one that failed, so check here first when something stops working all at once.
• Per-mod CET logs live in each mod folder; they follow the same DEBUG switch.

Test hardware used during development

• Headsets: PICO 4 (via VDXR); PlayStation VR2 compatibility uses SteamVR/OpenXR
• CPU: AMD Ryzen 7 5800X
• GPU: NVIDIA RTX 5070 Ti
• RAM: 32 GB DDR4
• OS: Windows 11 Pro 25H2 (26200)

Credits and acknowledgements

• HUDitor provides the standard-widget move/resize workflow used to align this tested VR HUD.
• nben/Cyberpunk-UI-mods-for-VR informed the quickhack/scanner controller and widget identification. Its mapping led this port to target the complete scannerDetailsGameController panel; explicit credit is retained here and in the HUD documentation.

Donations

Donating is your personal choice. It speeds up development and makes new features possible — nobody is forcing you to do it.

• https://boosty.to/dariulone
• https://dalink.to/dariulone

USDT TRC20	TRgmDeRcFumXvsSRqYV5kQAqRAvoFKXJCt
USDT BEP20	0x4638c6580d1e684bdc60a1c415e5cb1522b66942
TRX	TRgmDeRcFumXvsSRqYV5kQAqRAvoFKXJCt
BTC	13AfpBwZvaezf36FmpjtENHTXjYcnzEsze