《英灵神殿》1.0-1.0.16 镜头与移动稳定器，用于改善步伐晃动、抖动以及近距离视角压迫问题。

坚定不移

消除原版1.0移动时僵硬的步伐晃动，防止在墓穴中镜头被挤压到令人窒息，解锁自适应越肩视角，征服《英灵神殿》中的晕动症。

---

兼容性： 英灵神殿 1.0.0-1.0.16；最新构建、相机 Harmony 目标，以及隔离启动验证已在 1.0.16 上完成。参见 舰队兼容性证据.

---

📑 目录

• 🎯 请求与起源
• 🏗️ 视觉系统架构 (Archify)
• ⚡ 核心特性
  • 头部晃动分离与步伐稳定
  • 2. 地牢近距防压地板
  • 3. 自适应隐窝肩部升降器
  • 4. 动态地下城视野扩展
  • 5. 精细镜头晃动缩放器
  • 6. 帆船倾斜抑制
  • 7. 游戏内命令行与实时热键（F7)
• 🎮 快捷键速查
• ⚙️ 配置参考
• 💻 游戏内控制台命令（F5)
• 🔬 硬件验证（OMEN 设备）
• 📚 文档与指南
• 📦 安装指南
• 🛠️ 从源码构建
• 🤖 AI 披露与来源
• 🙏 鸣谢与致谢
• 📄 许可证

---

🎯 请求与起源

已经有人做恢复1.0之前跑步动画的模组了吗？那种僵硬的上下晃动看得我头晕。尤其是在墓葬墓穴里。
— 狂战士，瓦尔海姆模组制作社区

在《英灵神殿》1.0（极北之地）更新中，Iron Gate 重做了玩家移动混合树（玩家控制器）。虽然新的奔跑动画带来了更有弹性的步频，但Valheim的 游戏相机 将它的第三人称目标直接锚定到 角色.眼睛—动画颈椎/头部骨骼的子级变换。

在开放世界中（距离4–6米处）， Vector3.SmoothDamp 减轻了这次弹跳。但在内部 墓穴、沉没墓穴和冰霜洞穴狭窄的石廊引发 GameCamera.CollideRay2()，会将镜头距离强行压缩至 不到1米 就在那个维京人的脖子后面。

近距离时：

• 100%的原始步幅反弹 直接投射在玩家的视野中。
• 角色模型上下晃动，遮挡了超过70%的屏幕。
• 闪烁的火把阴影与狭窄的墙壁产生强烈的视觉-前庭冲突，从而引发 头痛、恶心和眩晕.

而不是等待资产替换 动画覆盖控制器 跨越游戏子补丁的， 坚定 在摄像机锚点层面解决问题：零依赖、零资源膨胀，以及完全符合人体工学的稳定性。

---

🏗️ 视觉系统架构（Archify）

Archify 认证展示地图，用于演示移动解耦钩子、地下城碰撞钳制以及实时调参管线：

👉 打开实时交互式Archify图表 (实时网页预览) （深色/浅色主题、引导式视图检查、节点可达性）

流程图 从左到右 子图 输入 ["玩家控制与命令行界面"] P输入["鼠标视角与WASD<br/>[F7] 实时稳定器切换"] 控制台["F5 控制台命令行<br/>'unswayed status' | 'unswayed damping'"] 结束 子图 英灵神殿 ["英灵神殿引擎运行时"] P移动["玩家移动<br/>1.0 奔跑步幅关键帧"] 摄像机["游戏摄像机<br/>活动视口锚点"] 地穴["墓葬地穴<br/>低矮天花板与门道"] 地平线["稳定地平线<br/>零步幅弹跳"] 视口["人体工学视口<br/>平滑第三人称视角"] 结束 子图 稳定 ["Unswayed Harmony 拦截器"] 偏移补丁["偏移解耦器<br/>GetCameraBaseOffsetPatch (1.65米)"] 管理器["稳定器引擎<br/>状态与阻尼滑块 (1.0)"] 防挤压["地牢防挤压<br/>地板1.35米与+0.35米抬升"] 结束 P输入 -->|鼠标与F7| 摄像机 摄像机 -->|摄像机位置| 管理器 P移动 -->|m_eye 弹跳| 偏移补丁 偏移补丁 -->|1.65米基准| 地平线 控制台 -.->|实时调校| 防挤压 防挤压 -->|碰撞射线检测| 地穴 管理器 -->|稳定视角| 视口

---

⚡ 核心功能

头部晃动解耦与步伐稳定

覆盖 获取摄像机基础偏移量() 将第三人称摄像机固定到一个稳定的、相对于根节点的枢轴上（向上1.65米)。摄像机平滑跟随地面移动，穿越山丘和地形，同时不受头部骨骼垂直关键帧弹跳的影响。

2. 地下城近距防挤压地板

墓葬墓穴通常会将镜头距离压缩到0.5米，紧贴你的脖子。Unswayed会强制执行一个可配置的最小距离下限（1.35米 default），确保你始终有喘息的空间和清晰的视野。

3. 自适应隐窝肩部提升

在狭窄空间中强制最小距离可能导致摄像机穿模到地牢外部天花板。Unswayed会轻柔地将摄像机向上抬升最多 +0.35米 随着空间变得狭窄，提供清晰的过肩视角，方便观察狭窄的地牢走廊。

4. 动态地下城视野扩展

隧道视野FOV会大幅加剧晕动症。当在狭窄的地牢走廊中被压缩时，Unswayed会平滑地将相机FOV扩大 +10° （例如65°→75°），提供稳定视野的外围视觉锚点。

5. 精细镜头震动缩放器

将全局镜头抖动强度调整为 0.0 (完全禁用) 至 1.0 （原版）消除令人迷失方向的脚步声震动，同时保留战斗打击反馈。

6. 帆船倾斜抑制

航行时可选锁定镜头地平线旋转（禁用飞船倾斜 = true)，防止在剧烈海上风暴中晕船。

7. 游戏内命令行界面与实时热键（F7)

按 F7 在飞行中随时切换稳定功能，立即感受差异。按 F5 打开开发者控制台进行运行时调试。

---

🎮 快捷键速查

按键	动作	上下文
F7	切换稳定	立即切换不受影响的镜头稳定功能的开启/关闭。
F5	控制台命令行	为以下对象打开英灵神殿开发者控制台 不为所动 指令。
鼠标移动	视角与俯仰	流畅的第三人称鼠标视角，无步伐晃动。
鼠标滚轮	距离缩放	在配置的最小高度和最大距离之间缩放镜头。

---

⚙️ 配置参考

配置文件： BepInEx/配置/djc.valheim.unswayed.cfg

章节	设置	默认	范围 / 类型	描述
1 - 通用	已启用	真	布尔值	Unswayed 插件的主开关。
1 - 通用	切换快捷键	F7	按键代码	游戏内热键，用于开启/关闭镜头稳定。
2 - 抑制视角摇晃	启用鲍勃抑制	真	布尔值	将摄像机基础偏移与动画头部骨骼解耦。
2 - 抑制头部晃动	压制模式	总是	始终, 仅奔跑, 仅限地下城	用于抑制摇晃的工作模式。
2 - 抑制头部晃动	稳定视野高度	1.65	1.2 到 2.2 （浮点）	相对于玩家根节点的稳定垂直视线枢轴高度。
2 - 抑制头部晃动	垂直阻尼	1.0	0.0 到 1.0 （浮点数）	阻尼量（1.0 = 地平线稳如磐石，0.0 = 原版晃动）。
3 - 地下城与墓穴人体工程学	启用地下城人体工程学	真	布尔值	在狭窄的地下墓穴走廊中启用自适应镜头行为。
3 - 地牢与墓穴人体工学	地牢距离阈值	2.0	1.0 至 4.0 (浮点数)	地牢适应功能激活的相机距离阈值。
3 - 地牢与墓穴人体工学	启用最小距离限制	真	布尔值	防止摄像机零距离贴近玩家头部。
3 - 地牢与墓穴人体工学	最小相机距离	1.35	0.6 至 2.5 （浮点）	狭窄空间中的最小镜头距离。
3 - 地牢与墓穴人体工学	启用CryptShoulderLift	真	布尔值	在低矮的地下城走廊中轻柔地抬高镜头。
3 - 地牢与墓穴人体工学	肩部抬起量	0.35	0.0 到 1.0 （浮点数）	在狭窄空间中施加的最大垂直抬升偏移。
3 - 地下城与墓穴人体工学	地牢视野增强	10.0	0.0 至 30.0 （浮点）	在狭窄地穴中额外增加的视野角度，以消除眩晕感。
4 - 屏幕震动与动态舒适度	镜头抖动幅度	0.0	0.0 到 1.0 （浮点）	全局镜头晃动倍率（0.0 = 禁用，1.0 = 原版）。
4 - 屏幕震动与动态舒适度	禁用船只倾斜	假	布尔值	在航行时抑制镜头翻滚倾斜，以防止晕船。

---

💻 游戏内控制台命令（F5)

按下 F5 在游戏内访问 坚定不移 指令套件：

unswayed status # 打印当前稳定模式、阻尼和地牢距离 unswayed toggle # 切换稳定开启/关闭（对应 F7 快捷键） unswayed height <float> # 调整视点高度（例如 unswayed height 1.70） unswayed damping <0.0 - 1.0> # 调整阻尼滑块（例如 unswayed damping 0.85） unswayed shake <0.0 - 1.0> # 调整镜头晃动幅度（例如 unswayed shake 0.25）

---

🔬 硬件验证（OMEN 主机）

坚定不移 已在主权硬件上测试并验证（预兆：Intel Core Ultra 9 285K，双 Intel Arc Pro B70 GPU）运行自动化 北境深处测试 护具：

========================================================== 北境深处测试 :: 英灵神殿 1.0 自主启动器 ========================================================== [正常] 英灵神殿正在运行，进程ID：39024（8秒内进入交互菜单） [通过] 检测到0个错误、0个异常、0个补丁失败。 [通过] 所有激活的BepInEx插件均已加载并正常修补。

已验证的BepInEx链式加载器日志：

[信息 : BepInEx] 正在加载 [Unswayed 1.0.0] [信息 : Unswayed] Unswayed v1.0.0 已初始化。视角摇晃抑制: 开启 (阻尼: 1.00)，地牢人体工学: 开启，震动幅度: 0.00。快捷键: [F7]

起飞前塞西尔反射审计：

========================================================== 北境深处测试 :: 英灵神殿 1.0 反射检查器 ========================================================== [+] 目标英灵神殿目录: C:\Program Files (x86)\Steam\steamapps\common\Valheim [+] 正在审核已安装插件于: BepInEx/plugins [摘要] 3 个插件验证无误。0 个架构警告。 [+] 审核已成功完成。

---

📚 文档与指南

• 🔍 技术说明与引擎反编译 — 深入探索 获取摄像机基础偏移, 碰撞射线2, 角色.眼睛 骨骼父子关系和平滑阻尼数学。
• 📖 野外工作手册与情景战术指南 一步步讲解请求狙击方法论、地牢测试场景（埋葬墓穴、沉没墓穴、平原疾跑）以及实时可观测性命令。
• 🗺️ 交互式 Archify 图 (实时网页预览)— 独立响应式HTML架构图，支持主题切换、组件隔离和引导式故事视角。
• 💡 知识库常见问题-005 — 对1.0版本奔跑动画弹跳问题的全面根因调查。

---

📦 安装指南

使用模组管理器（推荐）

1. 安装 r2模组管理器 或Thunderstore模组管理器。
2. 搜索 坚定不移 然后点击 使用模组管理器下载.

手动安装

1. 安装 BepInExPack 英灵神殿 （v5.4.2202或更新版本）。
2. 下载 Unswayed.dll 自最新版本起。
3. 放置 坚定.dll 到你的 Valheim/BepInEx/plugins/ 目录。
4. 启动《英灵神殿》！

---

🛠️ 从源码构建

要求：

• .NET SDK（8.0 或更高版本）
• 目标框架： net48

# 克隆仓库 git clone https://github.com/djcdevelopment/deepnorthtesting.git cd deepnorthtesting/plugins/Unswayed # 构建（自动部署到你的本地英灵神殿插件目录） dotnet build -c Release

---

🤖 AI 披露与来源说明

根据开源透明度和社区准则：

• AI辅助工程： 在人类架构指导下，通过人机协同结对编程（Google DeepMind Antigravity / Gemini）精心打造。
• 验证： 在主权本地硬件（OMEN设备）上100%验证通过，反射审计干净无误，零运行时错误，且架构模型已通过Archify验证。

---

🙏 制作人员与致谢

• 克鲁斯尼克：感谢您提出关于1.0版本跑步动画僵硬晃动和墓穴眩晕的关键社区反馈，直接启发了本插件的构思与人机工学设计。
• 北方深渊测试自主测试框架、Cecil 反射审计工具，以及 Valheim 1.0 模组开发研究。

---

📄 许可

在以下协议下分发 MIT 许可证版权所有 (c) 2026 djcdevelopment。