赛博朋克2077头部追踪

赛博朋克2077 头部追踪

用你的头部驱动夜之城的第一人称和载具视角，而鼠标或手柄仍控制瞄准。侧身探出掩体、探头观望、瞥一眼乘客，同时不失去准星。无需VR头显。

功能特性

• 视角与瞄准分离 - 头部追踪移动镜头；鼠标或手柄仍控制射击方向
• 6自由度追踪 - 通过移动头部来侧倾、探头和下蹲，而不仅仅是旋转
• 三种开镜瞄准方式 - 抬起武器时，视野总是会转向准星所标记的位置。之后可以选择：瞄准剩余期间关闭头部追踪（默认），开启追踪并显示一个标记指示子弹落点，或开启追踪但不显示标记。游戏中按 Insert 键循环切换
• 兼容任何支持OpenTrack协议的设备 - 网络摄像头、智能手机应用、硬件追踪器或VR头显

系统需求

• 一份已购买的 《赛博朋克2077》 游戏，版本 2.x，平台为Steam、GOG或Epic。不需要《往日之影》扩展包。
• Windows 10 或 11，64位。
• Cyber Engine Tweaks (CET) - 必需，不包含在本压缩包中。参见依赖项。
• RED4ext - 必需，不包含在本压缩包中。参见依赖项。
• TweakXL - 必需，不包含在本压缩包中。参见依赖项。
• OpenTrack，或任何支持OpenTrack UDP协议的追踪器 - 必需，不包含在内。参见依赖项。
• Native Settings - 可选，仅当您需要游戏内设置菜单时需要。参见依赖项。

依赖项

四个必需的依赖项和一个可选的依赖项。它们都不包含在本压缩包中；解压本模组前，请先从下方各自的链接安装每个依赖项。

RED4ext（必需，未包含）

• 下载：RED4ext（获取最新的 red4ext-x.y.z.zip）
• 安装：将压缩包解压到您的《赛博朋克2077》安装根目录，确保 red4ext/RED4ext.dll 和 bin/x64/winmm.dll 存在。启动游戏一次，让RED4ext初始化并创建 red4ext/logs/。

TweakXL（必需，未包含）

• 下载：TweakXL（获取最新的 TweakXL-x.y.z.zip）
• 安装：先安装RED4ext，然后将TweakXL压缩包解压到您的《赛博朋克2077》安装根目录，确保 red4ext/plugins/TweakXL/TweakXL.dll 存在。
• 其自身的依赖项：RED4ext。在TweakXL之前安装RED4ext。

Cyber Engine Tweaks（必需，未包含）

• 下载：Cyber Engine Tweaks（获取最新的 cet_x.y.z.zip）
• 安装：将压缩包解压到您的《赛博朋克2077》安装根目录，确保 bin/x64/plugins/cyber_engine_tweaks.asi 存在，位于 bin/x64/plugins/cyber_engine_tweaks/ 文件夹旁边。启动游戏一次并完成CET的首次运行提示，然后确认按 ~ 键可以打开CET控制台。

OpenTrack或其他兼容OpenTrack的追踪器（必需，未包含）

• 下载：OpenTrack（获取最新的Windows安装程序）
• 安装：使用默认设置运行安装程序。配置在下方的“设置”部分说明。
• 替代方案：任何能够向您的电脑4242端口发送经过滤波的OpenTrack UDP数据包的手机应用或追踪器。我制作了 Headcam，让任何拥有Android或iOS设备的人都可以免费使用。

Native Settings（可选，未包含）

• 下载：Native Settings
• 安装：按照其页面上的说明操作。它是一个CET模组，因此需要先安装Cyber Engine Tweaks。

安装

1. 按以下顺序安装上述所有依赖项： RED4ext，然后是TweakXL，然后是Cyber Engine Tweaks，最后是OpenTrack（或您选择的追踪器）。Native Settings是可选的，可以在CET之后随时安装。安装加载器后启动游戏一次，让每个加载器初始化并创建其文件夹。有关每个依赖项的链接和步骤，请参阅“依赖项”部分。
2. 从文件选项卡下载 -nexus 压缩包。
3. 将压缩包内容解压到您的《赛博朋克2077》安装目录，确保 init.lua 最终位于 <Cyberpunk 2077>/bin/x64/plugins/cyber_engine_tweaks/mods/HeadTracking/init.lua。压缩包完全镜像游戏文件夹结构，因此只需“解压到此处”到游戏根目录即可。典型的游戏根目录：
   • Steam： <Steam库>/steamapps/common/Cyberpunk 2077/
   • GOG： C:/GOG Games/Cyberpunk 2077/
   • Epic： C:/Program Files/Epic Games/Cyberpunk 2077/
4. 启动您的追踪器 并将其输出设置为 UDP 127.0.0.1:4242（如果您使用直接发送的手机应用，则设置为 [您的局域网IP地址:4242]），然后启动《赛博朋克2077》。首次启动会在 bin/x64/plugins/cyber_engine_tweaks/mods/HeadTracking/ 下创建包含默认值的 config.json。

成功安装的标志：

• red4ext/logs/HeadTrackingAim.log 存在且包含 [HeadTrackingAim] UDP receiver listening on port 4242。
• CET控制台（游戏内按 ~）显示 [HeadTracking] 启动信息。
• bin/x64/plugins/cyber_engine_tweaks/mods/HeadTracking/config.json 已创建。
• 在追踪器运行时，移动头部会移动镜头，而鼠标仍可独立瞄准。

设置 / 配置

设置OpenTrack

在OpenTrack中，将 输出 设置为 UDP over network：

• 远程IP： 127.0.0.1（如果您使用手机应用，则为游戏电脑的局域网IP）
• 端口： 4242

选择适合您追踪器的 输入，然后在启动游戏前点击 开始。如果Windows防火墙提示，请允许UDP 4242通过。

网络摄像头

• 在OpenTrack中，将 输入 设置为 Neuralnet Tracker。它无需红外标记即可工作。
• 选择您的网络摄像头，点击开始，并确认头部模型在OpenTrack的预览中跟随您的移动。

VR头显

• 连接您的头显（Air Link、Virtual Desktop、Link电缆等）并启动SteamVR。
• 在OpenTrack中，选择SteamVR输入插件，以便读取您的头显姿态。
• 将输出设置为“UDP over network”，主机 127.0.0.1，端口 4242。
• 点击开始，然后启动游戏。

手机应用

• 直接发送：将应用指向您电脑的局域网IP，端口 4242。如果您的应用已经平滑了其输出，请使用此方法，我的应用 Headcam 可以免费做到这一点。
• 通过OpenTrack：让手机向OpenTrack的另一个端口（例如5252）发送数据，然后让OpenTrack的输出转发到 127.0.0.1:4242。如果您希望在链路中使用OpenTrack的曲线映射或滤波器，请使用此方法。

模组配置

设置位于 <Cyberpunk 2077>/bin/x64/plugins/cyber_engine_tweaks/mods/HeadTracking/config.json，在首次启动时创建。请在游戏关闭时编辑它，或者如果您安装了Native Settings，也可以使用游戏内的Native Settings菜单。附带的默认值：

{
  "enabled": true,
  "sensitivity_yaw": 1.0,
  "sensitivity_pitch": 1.0,
  "sensitivity_roll": 1.0,
  "local_smoothing": 0.0,
  "remote_smoothing": 0.15,


  "clamp_yaw": 120.0,
  "clamp_pitch": 80.0,
  "clamp_roll": 45.0,


  "crosshair_enabled": true,
  "crosshair_fov_degrees": 84.0,
  "crosshair_lead_factor": 0.0,

  "ads_reticle_enabled": true,
  "ads_reticle_size": 12,
  "ads_reticle_opacity": 0.8,


  "position_enabled": true,
  "position_sens_x": 1.0,
  "position_sens_y": 1.0,
  "position_sens_z": 1.0,
  "position_limit_x": 0.30,
  "position_limit_y_up": 0.20,
  "position_limit_y_down": 0.05,
  "position_limit_z_fwd": 0.40,
  "position_limit_z_back": 0.10,


  "yaw_mode": "world"
}

关于投射子弹

该模组会将玩家的枪械射击永久切换为游戏自带的投射物攻击，而不仅仅是在时停期间。这与使子弹在斯安威斯坦下可见的代码路径相同，也正是实现视角分离的关键。这是一个真实的游戏性改动，因此了解其影响是值得的：

• 子弹有飞行时间。在正常交战距离下您不会注意到；在远距离时，您需要稍微提前瞄准移动目标。
• 子弹是物理对象。您可以看着它们飞行，它们会与世界互动，而不是瞬移到目标上。
• 能够穿透掩体充能的技术武器保持其自身行为，不受影响。
• NPC不会被转换。敌人射击方式与原版完全相同，因此交火不会产生大量额外的物理对象。
• 子弹速度设置为200，这是基础游戏为任何投射物使用的最高速度。
• 23种独特或任务武器（包括MA70、空投变体、Nova Doom Doom 和 Saratoga Maelstrom）仍为即时命中判定，不会进行分离。

所有这些都通过一个TweakXL文件应用，因此删除模组即可完全恢复原始行为。

控制 / 使用

有两套等效的按键绑定，请使用您键盘上可用的一套。两套绑定始终处于激活状态，按下任一配对按键都会触发一次该动作。

动作	导航键区	组合键
切换追踪	End	Ctrl+Shift+Y
循环追踪模式	Page Up	Ctrl+Shift+G
切换偏航模式	Page Down	Ctrl+Shift+H
循环开镜模式	Insert	Ctrl+Shift+U

Page Up 或 Ctrl+Shift+G 循环切换追踪模式：

1. 正常的头部追踪游戏玩法
2. 禁用位置追踪，启用旋转追踪
3. 禁用旋转追踪，启用位置追踪
4. 返回正常模式

Insert / Ctrl+Shift+U 循环切换开镜瞄准时发生的情况。所有三种模式都以相同方式开始 - 抬起武器时，视野会转到准星所标记的位置，因此您的射击会命中您之前对准的位置 - 它们的不同之处在于瞄准剩余期间发生的情况：

1. 追踪暂停（默认） - 只要准星抬起，游戏就保持该镜头。瞄准画面与游戏完全一致，在您放下武器之前，头部移动不产生任何效果。
2. 追踪开启，并带瞄准标记 - 头部追踪从吸附位置继续，并绘制一个小白色准星指示子弹实际落点。这个白色标记是权威的，包括使用带瞄准镜的武器时。瞄准镜内置的十字线仅在您的眼睛与光学器件精确对齐时才准确，因此当头部追踪将您的视线移开该瞄准线时，两个准星会分离。
3. 追踪开启，无瞄准标记 - 与模式2相同但没有标记，当您满意于阅读瞄准具本身时，屏幕更干净。瞄准难度极高。

该选择会被保存，因此重启后仍然有效。按下按键会显示一个提示，告知您切换到的模式。

卸载

从您的《赛博朋克2077》安装目录中删除以下内容：

• bin/x64/plugins/cyber_engine_tweaks/mods/HeadTracking/ （整个文件夹，同时删除 config.json、HeadTracking.log 和 HeadTracking-diag.log）
• red4ext/plugins/HeadTrackingAim.dll
• r6/tweaks/HeadTracking_ProjectileBullets.yaml
• red4ext/logs/HeadTrackingAim.log （可选，仅日志文件）

删除tweak文件会立即恢复原始的即时命中判定射击；此更改不会以任何方式写入您的存档。

卸载依赖项是可选的，并非恢复游戏原始行为所必需。RED4ext、TweakXL 和 Cyber Engine Tweaks 是与其他模组共享的通用加载器，除非您出于自身原因想要删除它们，否则请保留它们。OpenTrack 是一个独立的桌面应用程序，与模组没有任何耦合。

致谢

• CD PROJEKT RED，《赛博朋克2077》的开发商和发行商
• Cyber Engine Tweaks 作者 maximegmd，托管Lua模组
• RED4ext 和 RED4ext.SDK 作者 WopsS，加载原生插件
• TweakXL 作者 psiberx，应用投射物更改
• GameUI 作者 psiberx，用于游戏状态检测
• OpenTrack 头部追踪协议和软件
• Dear ImGui 作者 Omar Cornut，用于游戏内覆盖层（通过CET使用）

与 CD PROJEKT RED 无关联、未经其认可或支持。

源代码与许可证

https://github.com/itsloopyo/cyberpunk-2077-headtracking

根据 MIT 许可证发布