PEAK 支持 OpenTrack 兼容头部追踪

PEAK头部追踪



使用任意兼容OpenTrack的追踪设备（网络摄像头、手机应用或专用硬件），实现PEAK的分离式头部追踪。

特性
- 分离视角+瞄准 - 头部可自由环顾四周，鼠标瞄准保持独立
- 六自由度追踪 - 全方位旋转（偏航角、俯仰角、翻滚角）与位置追踪（X、Y、Z轴）
- 兼容任何OpenTrack信源 - 网络摄像头、手机应用、TrackIR，或任何支持OpenTrack的追踪设备
UDP

需求
- https://thunderstore.io/c/peak/p/BepInEx/BepInExPack_PEAK/ — 须优先安装

安装
将 BepInExPack_PEAK 文件夹中的内容解压至你的游戏目录
2. 将此压缩包解压至游戏文件夹——DLL文件会自动放入 BepInEx/plugins/ 目录内。
3. 配置你的追踪器，将UDP输出至 127.0.0.1:4242
4. 启动游戏

设置追踪器
使用OpenTrack（PC摄像头驱动）：
下载并安装 https://github.com/opentrack/opentrack/releases
将输入源设置为“神经网络追踪器”（网络摄像头）或你偏好的来源。
设置网络输出为 UDP - 主机：127.0.0.1，端口：4242
点击“开始”，然后启动游戏

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

注意：若手机应用追踪质量不佳，可通过 OpenTrack 进行平滑处理，例如将数据发送至指定端口。
请确保在防火墙中开放端口5252，并将OpenTrack的数据发送至模组的127.0.0.1:4242。

操作
- 结束 - 开启/关闭头部追踪
- 主页 - 重置视角
- 上一页 - 开启/关闭位置追踪

配置
编辑 BepInEx/config/com.cameraunlock.peak.headtracking.cfg 文件，自定义灵敏度、平滑度、死区、反转设置
位置限制，以及快捷键绑定。

故障排除

模组未加载：
- 请确保游戏文件夹中存在 winhttp.dll（由 BepInEx 安装）
- 确认所有模组 DLL 文件均位于 BepInEx/plugins/ 文件夹内
请确认你使用的是 BepInEx 5.x（非 6.x）
检查 BepInEx/LogOutput.log 文件以查看错误

无追踪响应：
请确保追踪器正在运行，并将数据输出到 127.0.0.1:4242
按下【End】键可切换追踪状态
- 按Home键重置视角
检查 BepInEx 日志以查看错误信息

镜头抖动：
- 请在配置文件中增加平滑处理
- 在配置文件中启用死区
- 优化摄像头追踪的灯光效果

正在卸载

从 <PEAK>/BepInEx/plugins/ 中删除：
峰值头部追踪.dll
CameraUnlock.Core.dll
CameraUnlock.Core.Unity.dll

要移除所有模组，请同时删除游戏根目录下的 BepInEx 文件夹和 winhttp.dll 文件，然后通过游戏平台验证文件完整性。
Steam 平台。

制作人员
- https://aggrocrab.com/ - 阿格罗蟹游戏工作室，《PEAK》开发商
- https://github.com/opentrack/opentrack - 头部追踪协议及软件
- https://github.com/BepInEx/BepInEx——Unity模组开发框架
- https://github.com/pardeike/Harmony — 运行时修补库

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