dariulone/cyberpunk-vr-port

项目介绍

CyberpunkVR Port 是《赛博朋克 2077》PC 版的社区 VR 模组，以一个 RED4ext 插件（cyberpunkvrport.dll）分发。它把 OpenXR 头显追踪注入 REDengine，并真正渲染第二只眼睛的画面，而不是对平面图像做重投影。在此基础上，项目用 Lua 与 redscript 脚本实现了大量 VR 专属玩法：全身头像 IK、武器瞄准与枪口解耦、实体换弹、挥砍近战、用双臂驱动义体、实体下蹲、手动握方向盘驾驶，以及头显内的原生 HUD 和设置面板。它面向拥有 PC VR 头显、希望在现有游戏内获得体感控制器体验的玩家，而不是独立的 VR 游戏。

快速使用

模组面向游戏 2.5 版本，2.31 已不再支持。先安装 RED4ext 1.31.0 或更新版本，再安装以下依赖：Visual Holsters、Equipment-EX、Nova Optics 和 More Occluders (Scripted v0.3)。Cyber Engine Tweaks、ArchiveXL、TweakXL、Input Loader、Codeware 与 redscript 不是必需项——插件自己运行 Lua 和 redscript 内容，不过其他模组可能仍需要它们。

下载发布压缩包并解压到游戏根目录（包含 bin\、r6\、red4ext\ 的文件夹），文件会落到 red4ext\plugins\cyberpunkvrport\。从 0.1.9 或更早版本升级时，需删除已废弃的 CyberpunkVR_Stereo.dll 和旧的 CyberpunkVR_Stereo 文件夹，并按安装说明移除废弃的脚本目录和归档（source:7）。启动游戏前先启动 OpenXR 运行时。首次启动时，VR 预设会合并进 UserSettings.json 并生成带时间戳的备份。游戏中长按 L3+R3 半秒打开 VR 菜单，或按 F10 打开头显内设置面板（source:11）。源码构建可用以下命令安装：

cmake --build build --config Release --target cyberpunkvrport_stereo
pwsh scripts\deploy_stereo.ps1 -GameRoot "<游戏根目录>"

每个 red4ext\plugins\CyberpunkVR_* 目录只保留一个 DLL；RED4ext 会加载找到的所有 DLL，改名备份会和正式构建争抢同一批 hook。任何其他代理 dxgi 的模组（例如 R.E.A.L. VR）都必须从 bin\x64 移走。

操作与配置

VR 控制器输入会合并进游戏原生手柄映射，因此游戏内“控制器”键位仍然生效。默认映射包括步行移动、瞬转或平滑转向、冲刺、实际下蹲、在左耳处做手势打开扫描仪、手到枪套的装备/卸下，以及用副手抓弹匣。驾驶时控制器改为倾斜转向、油门刹车、鸣笛和长按下车。热键包括 F7 重新居中、F8 切换菜单矩形、F10 或 Insert 打开设置面板（source:10）。面板把设置保存到 vrport.ini，分通用、帧生成、HUD、控制、双目、头像、驾驶和按键绑定几页。

使用约束

这是实验性社区模组，与 CD PROJEKT RED 无关；README 建议备份存档。仅支持 Windows 和 2.5 版 PC 游戏，需要可用的 OpenXR 运行时，同时支持 SteamVR（OpenVR）。性能与稳定性取决于头显、显卡和上采样器；帧生成、注视点 DLSS 和可变速率着色是可选功能且依赖 GPU，非 NVIDIA 显卡的光流会回退到 FidelityFX。项目使用 MIT 许可证，问题报告所需的日志位于 Cyberpunk 2077\red4ext\plugins\cyberpunkvrport\log\cyberpunkvrport.log（source:13）。

HotRepo 点评

该项目出现在 HotRepo 2026-11-04 的 C++ 日榜快照中，当时为 467 星、53 个 Fork，单日新增 17 星，位列 C++ 日榜第 7。这只是单日记录，不足以说明持续热度。技术上更值得注意的是规模：真正的逐眼渲染路径、修正后的屏幕空间通道、逐眼上采样器，以及 19 款头显、188 种分辨率的预设；组件表把插件、Lua 模组和 redscript 文件分列清楚。这种广度也意味着更高的安装门槛——精确的游戏版本、多个 Nexus 依赖，以及升级时需要仔细清理旧文件——因此它更适合愿意严格按步骤安装的玩家，而不是拿来即用的入门 VR 体验。