响应式英灵神殿驯服骑乘，支持直接操控、冲刺、跳跃、原生坐骑攻击、耐力、践踏、骑乘自动拾取，以及坐下/保持位置指令。

驯服骑乘大修 v0.1.20

更具响应性的英灵神殿坐骑控制器的实验性首个版本。

固定朝向锁定（v0.1.20）

骑乘并停止时，已驯服生物现在会保持骑手选定的朝向，而不再让原版的待机或AI视角更新自行旋转它。A/D转向和S键180度转身仍是主动转向输入，W移动不受限制，且在空中时不会应用该锁定。

控制

使用Valheim现有的输入绑定，因此重新映射的控制仍然有效。

• W — 按住时前进
• A / D — 左转/右转，包括原地不动时
• S ——将坐骑掉头180°（无倒挡）
• Shift / 奔跑 —疾跑使用普通鞍座的体力系统
• 空格 / 跳跃 — 坐骑跳跃
• 鼠标左键 / 攻击 — 生物攻击 1
• 人民币 / 方块 — 生物攻击 2
• MMB / 副攻击 — 生物攻击 3 / 特殊
• Shift + Y — 切换 坐下 你正在注视的可骑乘驯服生物（可配置）

坐下快捷键的匹配基于修饰键，而非精确按键状态匹配，因此按住无关的移动键不会阻止该命令。显示的悬停快捷键根据实时配置生成。

当骑乘战斗启用时，骑手自身的攻击/格挡输入会被消耗，改由坐骑发动攻击。

生物等级 / 星级

默认解锁特意与原版的三个生物等级保持一致：

生物等级	显示	可用的攻击
1	无星	攻击 1
2	1星	攻击1 + 攻击2
3	2星	攻击1 + 攻击2 + 攻击3/特殊技

等级高于3的生物（来自其他模组）直接保留全部三个槽位。TameRidingOverhaul不会添加自己的伤害缩放，而是使用生物已有的攻击物品，因此会保留游戏或其他模组所应用的等级/属性倍率。

生物只能使用其默认攻击物品列表中实际存在的攻击槽位。例如，只有两个原生攻击的生物不会获得虚构的第三个攻击。

移动

v0.1合并了两项改动：

1. 直接的A/D转向设定的是期望的坐骑朝向，而不是仅仅依赖原版那种迟钝的转向手感。
2. 被骑乘角色的移动数值在有人骑乘时会成倍增加，并在下坐骑后恢复。

默认值：

• 正常移动： 1.35倍
• 冲刺/奔跑： 1.70倍
• 加速： 2.0x
• 转向速度： 2.5倍
• 直接转向： 160 度/秒

所有数值均可配置。

践踏

默认开启践踏。当坐骑达到足够速度时，可以破坏或穿过选定的小型植被。v0.1.16 明确识别了此前被通用名称／尺寸过滤器漏掉的小型自然植物变种，包括：

• 山毛榉_小1 / 山毛榉_小2
• 小冷杉 / 小枯杉树
• 亚格射击_小型1
• 布什01, 灌木01_荒野, 北境灌木01, 灌木02_英
• 灌木_2 / 灌木2_荒地
• 已被现有类别规则覆盖的小树枝/嫩芽预制件

即使它们的渲染器/碰撞体组合边界超出范围，这些显式小型植物预制体也是允许的 最大障碍尺寸. 完整的树（树基）、原木（树木日志)、建筑部件、WearNTear 结构、种植的 种植 物体、生物和掉落的散落物品仍受到明确保护。

自然树苗踩踏作为配置选项存在，但默认禁用。

坐下/保持位置指令 (v0.1.19)

可骑乘的驯服生物现在拥有持久的 坐下 状态。坐下是保持位置指令；它不需要专门的生物坐下动画。

• 默认快捷键： Shift + Y 看着一只已驯服的骑乘生物时。
• 再次按下快捷键以解除坐下。
• 下马后默认自动启用坐下。
• 骑乘会自动解除坐下状态，以便立即骑乘该生物。
• 坐下会清除驯服生物的跟随目标，将其状态保存在ZDO中，并在激活期间抑制AI移动。驯服生物仍可转向、攻击或反应；该命令旨在保持其位置，而非冻结物理。
• 默认 Shift + Y 绑定与《英灵神殿》的驯服重命名手势不重叠（Shift + E) 或表情轮盘（T）。该快捷键仍可配置。
• 旧版默认按键绑定会通过现有的一次性迁移迁移到 Shift + Y；自定义按键绑定保持不变。

配置：

[坐下] 启用 = 是 按键绑定 = Y + 左Shift 骑乘时坐下 = 是

BepInEx可能会以略有不同的方式序列化键盘快捷键文本；如果你想使用其他按键绑定，请使用配置管理器或编辑生成的配置项。

配置

首次启动后：

Valheim/BepInEx/config/uk.ainzworth.valheim.tameridingoverhaul.cfg

重要设置包括：

• 速度倍率
• 直接转向和转向速率
• 原地转向辅助
• 跳跃启用/强制/冷却
• 骑乘战斗启用
• 攻击解锁等级
• 践踏启用、最低速度、半径、大小限制、伤害和植被类别
• 坐下启用、按键绑定，以及自动下坐骑后坐下
• 调试日志记录

建造

来自 PowerShell：

递归获取所有子项并解除文件锁定，然后运行 .\build.ps1 并安装

默认英灵神殿路径：

C:\Program Files (x86)\Steam\steamapps\common\Valheim

自定义路径：

.\build.ps1 -ValheimDir "D:\SteamLibrary\steamapps\common\Valheim" -Install

v0.1 测试重点

这特意是首个玩法测试版本。请按以下顺序测试：

1. 反复骑乘和离开，确认离开后生物移动恢复正常
2. W/A/S/D 以步行速度转向
3. 冲刺和骑乘耐力的消耗
4. 地面跳跃
5. 0星/1星/2星攻击解锁
6. 移动时的攻击动画和冷却时间
7. 灌木丛、树枝和 小杉树 碰撞/踩踏
8. 多人游戏（如可用）

启用 调试日志 = 开启 并发送 BepInEx/LogOutput.log 如果特定生物的行为异常。

当前移动行为

• W：仅在按住时前进
• Shift+W：仅在按住且体力允许时冲刺
• A/D：左右转向，静止时也可使用
• 按一次可使坐骑调转180度；没有倒挡
• 松开W键会使持续的原版鞍座油门回到停止状态
• 骑乘时禁用原版自动奔跑
• 骑乘状态下外部生物等级变化会被记录；本模组不会改变生物等级

v0.1.5 骑乘耐力

驯服骑乘大修现在使用坐骑耐力作为共享的移动/战斗资源：

• 正常向前骑行会缓慢消耗体力。
• 正常骑行不消耗体力；冲刺则持续消耗体力。
• 主要、次要和特殊坐骑攻击各自消耗可配置的耐力。
• 当坐骑没有足够体力支付全部消耗时，攻击会被格挡。
• 冲刺会在耐力耗尽时自动降为普通骑行。
• 体力在冲刺或攻击恢复延迟结束后会快速恢复，包括正常骑行期间。
• 原版鞍具耐力值保持权威设定，以便现有的坐骑耐力界面仍能正常使用。

默认值：

[体力] 启用 = true 移动消耗每秒 = 0.0 # 旧版/已忽略；普通骑乘始终免费 冲刺消耗每秒 = 8.0 每秒恢复 = 18.0 恢复延迟秒数 = 0.75 最低冲刺体力 = 1.0 主攻击消耗 = 10.0 副攻击消耗 = 16.0 特殊攻击消耗 = 24.0

v0.1.7 骑乘自动拾取

瓦尔海姆通常会在玩家附着于/骑乘坐骑时抑制玩家的自动拾取行为。TameRidingOverhaul 现在会在骑乘时恢复自动拾取。

坐骑实现：

• 尊重英灵神殿正常的自动拾取开/关切换功能
• 使用玩家当前的自动拾取范围，包括其他模组带来的范围变化
• 扫描坐骑周围，而不是骑手附加的高位变换
• 敬意物品 自动拾取、物品栏容量、负重、归属、焦油状态、独特物品限制及正常拾取资格
• 在物品进入坐骑拾取范围后直接收集符合条件的物品，这样快速冲刺时就不会跑赢原版的物品吸引动画。

配置：

[AutoPickup] 启用 = true 范围倍率 = 1.0 扫描间隔秒数 = 0.08

设置 已启用 = false 保留原版骑乘时不会自动拾取的行为。

v0.1.7 兼容性修复

• 修复针对英灵神殿1.0.15版本的编译问题，其中 角色.面部朝向() 是非公开的。
• 现在原地A/D转向会通过Harmony反射调用Valheim内部方法，并带有安全直接旋转的回退机制。
• 与v0.1.6相比，无玩法/平衡性改动。

v0.1.9 移动修正

坐骑控制现在特意采用《英灵神殿》角色风格的语义：

• W：仅按住时前进；使用英灵神殿常规鞍具前进控制路径
• Shift + W按住时冲刺，前提是耐力充足
• A / D：左转/右转，并可在静止时转动坐骑
• S：按一次让坐骑掉头180度，不是倒车挡
• 释放 W将持久原版鞍座油门强制拨回“停止”
• S 不会消耗移动耐力，因为它不会移动坐骑

直接写入行走/奔跑/后退 鞍座.m_speed 在v0.1.4中引入的内容已被移除，因为它们影响了在Valheim 1.0.15中直接骑行的体验。

Valheim 1.0.15 还通过以下方式显示鞍座耐力 体力, 设置体力，以及 获取最大体力；v0.1.9 不再探测已移除的 体力 领域，从而消除那个和谐警告。

v0.1.9 耐力/战斗修正

• 普通 W 骑乘不再消耗坐骑耐力。遗留的 每秒移动消耗 配置键仅为保持配置兼容性而保留，会被忽略。
• 正常骑行可能在配置的恢复延迟后恢复体力。持续消耗仅用于 Shift + W 冲刺。
• 鼠标左键/右键/中键攻击仍会消耗其配置的离散耐力消耗。
• 骑乘攻击现在会使用生物运行时拥有的攻击物品，并保持所选的攻击武器处于装备状态，直到《英灵神殿》的攻击状态结束。这修复了攻击有动画但未造成伤害的问题，该问题是因临时攻击物品过早恢复所导致的。
• 外部生物等级变化仅记录于调试日志。BetterTames等模组可能会在击杀后有意提升驯服生物的等级；TameRidingOverhaul本身不会修改生物等级。

空中动画/音频行为（v0.1.13）

驯服骑乘大修不再覆盖坐骑腾空时的移动动画或移动音效。玩家触发的 空格 跳跃使用配置的跳跃物理参数，但瓦尔海姆完全掌控生物在空中时的动画与音频状态。

来自 v0.1.10 的独立静止待机修复仍然有效：当坐骑实际停止后，残留的移动输入和移动混合参数会同步回待机状态，因此站立不动时移动循环不会无限持续。

键盘布局

基于字母的Sit键位会跟随当前键盘布局。使用默认 Shift + Y，德语QWERTZ键盘用户请按标有 Y，而不是标注为Z的实际US-Y位置。