英灵神殿头部追踪

《英灵神殿》头部追踪



《英灵神殿》平面屏幕头部追踪——无需VR头显。使用网络摄像头、手机或任何兼容OpenTrack的追踪器，通过移动头部来环顾世界，同时瞄准仍由鼠标控制。游戏依然是普通的显示器体验，只是你的头部控制视角。

功能
- 解耦视角与瞄准 - 自由转动头部环顾四周，鼠标瞄准保持独立
- 六自由度追踪 - 完整旋转（偏航、俯仰、翻滚）和位置追踪（倾斜、窥视、下蹲）
- 适用于任何兼容OpenTrack的来源 - 网络摄像头、智能手机应用、TrackIR，或任何支持OpenTrack UDP的设备

需求
- 在Steam上购买的英灵神殿副本
- Windows 10 / 11（64 位）
- BepInEx 5.x

安装
1. 安装 BepInEx 5。将 x（BepInEx_win_x64 zip）解压到你的 Valheim 文件夹中。
3. 将模组zip文件解压到你的Valheim文件夹中。DLL文件会放在BepInEx\plugins\ValheimHeadTracking\目录下：
   - ValheimHeadTracking.dll
   -CameraUnlock.Core.dll
   - CameraUnlock.Core.Unity.dll
   - 相机解锁.核心.Unity.BepInEx.dll

设置追踪器
使用OpenTrack（电脑摄像头）：
下载并安装 OpenTrack
- 将输入设置为“神经网络追踪器”（网络摄像头）或你偏好的来源
- 将输出设置为“通过网络UDP” - 主机：127.0.0.1，端口：4242
- 点击“开始”，然后启动游戏

使用手机应用：
- 在手机上安装与 OpenTrack 兼容的头部追踪应用
将其设置为发送到你电脑的IP地址（运行ipconfig查看），端口为4242
在手机上开始追踪，然后启动游戏

注意：该模组内置了网络抖动平滑处理，所以手机可以直接向4242端口发送数据。如果追踪仍然抖动，请通过OpenTrack中转：先从手机发送到OpenTrack的另一个端口（例如5252，需要在防火墙中开放该端口），再从OpenTrack发送到模组的127.0.0.1的4242端口。

操作
两套等效的按键绑定——你的键盘有哪套就用哪套。组合键字母位于键盘中部，因此在没有导航键区的笔记本电脑上也能使用。

跟踪模式循环依次切换 **6DOF（旋转 + 位置）-> 仅 3DOF 旋转 -> 仅 3DOF 位置 -> 6DOF**。使用主开关（`End` / `Ctrl+Shift+Y`）可完全关闭跟踪。

| 动作 | 导航簇 | 和弦 |
|----------------------------|-------------|-----------------|
| 切换头部追踪 | `End` | `Ctrl+Shift+Y` |
| 周期追踪模式 | `Page Up` | `Ctrl+Shift+G` |
| 切换偏航模式 | `Page Down` | `Ctrl+Shift+H` |
| 切换瞄准准星 | `Insert` | `Ctrl+Shift+U` |

偏航模式切换（Page Down / Ctrl+Shift+H）可在世界锁定偏航（默认，地平线稳定）与相机局部偏航（跟随相机当前上轴）之间切换。如果你在极端角度抬头或低头时感觉偏航不对劲，试试这个。

配置
该模组首次启动时会在 Valheim\BepInEx\config\com.cameraunlock.valheim.headtracking.cfg 写入一个配置文件。常用设置：

[通用]
启动时启用 = true
WorldSpaceYaw = true

[网络]
Udp端口 = 4242

[灵敏度]
偏航灵敏度 = 1.0
俯仰灵敏度 = 1.0
灵敏度 = 1.0

[反转]
反转偏航 = false
反转俯仰 = false
反转滚动 = false

瞄准解耦
启用瞄准解耦 = true
显示解耦准星 = true

[位置]
PositionLimitY = 0.15
PositionLimitYDown = 0.05

删除该文件以将所有设置重置为默认值。

故障排除

模组未加载：
- 验证 BepInEx 是否已安装（运行游戏一次后，查看 BepInEx\LogOutput.log 是否存在）
- 确保所有四个 DLL 文件都位于 BepInEx\plugins\ValheimHeadTracking\ 中
- 检查 BepInEx\LogOutput.log 中的错误信息

无追踪响应：
- 确认OpenTrack（或你的手机应用）正在运行并主动发送数据
- 验证UDP输出是否设置为 127.0.0.1:4242（如果从手机端追踪，则设为你的电脑局域网IP）
- 按 End 键开启追踪
- 检查防火墙是否未阻止UDP端口4242

镜头抖动：
- 在OpenTrack中增加平滑/过滤（推荐使用Accela滤波器）
- 在模组配置中降低灵敏度
- 改善基于网络摄像头的追踪的光照
- 在WiFi手机追踪中，出现一些抖动是正常的——模组内置的平滑处理有所帮助，但无法完全弥补严重的丢包问题

旋转轴错误：
- 在配置文件中翻转 InvertYaw、InvertPitch 或 InvertRoll，或直接在 OpenTrack 中调整曲线

更新中
下载新版本并解压到游戏目录。你的配置会保留。

正在卸载
- 删除文件夹：<Valheim install>\BepInEx\plugins\ValheimHeadTracking\（包含全部四个 DLL 文件）。
可选：删除配置文件：<Valheim install>\BepInEx\config\com.cameraunlock.valheim.headtracking.cfg。
- 若要同时移除 BepInEx 本身（仅在你只是为此模组安装它时才这样做）：请从 Valheim 文件夹中删除 BepInEx\、winhttp.dll、doorstop_config.ini 和 .doorstop_version。

制作人员
- 铁门工作室，英灵神殿的开发者
- BepInEx- Unity模组框架
- 和谐 - 运行时补丁库
- OpenTrack 头部追踪协议和软件

源代码
https://github.com/itsloopyo/valheim-headtracking - MIT许可证