通过可配置的铺装道路放置和冲刺加成，让瓦尔海姆的道路值得建造和使用。

特雷德韦尔

修筑值得一走的路。

特雷德韦尔是一个专注的原版增强型英灵神殿模组，让道路建造不再繁琐，使用更有回报。平整地面、小径和铺装道路可以使用更大或更小的同步地形笔刷，泥土小径和铺装道路提供适度的冲刺加成。

1.0.1 是当前的生产版本。 移除无需切石机的铺装道路选项，并恢复原版切石机需求。可调节半径，键盘行 Alt + 滚轮 — 调整大小 提示、道路奖励和摄像头滚轮隔离与经过实机测试的1.0.0版本行为保持不变。

功能

• 可调节地形笔刷： 与原版锄头完全相同 平地, 帕森或 石板路 操作已选定，按住 左Alt键或右Alt键 并在0.5米步进内上下滚动。平地从1–8米不等；土路和铺装道路从1–10米不等。可见的 仅幽灵 笔刷标记和放置地形操作使用相同的比例尺。
• 内置操作提示： 持久的键盘放置行增加 Alt + 滚轮 — 调整大小 仅当三个已验证的地形操作之一被选中且地块选择器关闭时才显示。对于抬升地面、无关或已更改的地块、无效或有歧义的笔刷发现、打开的地块选择器以及控制器输入，该提示会隐藏。
• 输入隔离： 当原版锄头处于放置模式时，Alt+滚轮不会缩放镜头——即使在半径边界处或选中了不合适的锄头操作也是如此。不使用Alt、使用其他工具或打开建造选择UI时，普通镜头缩放保持不变。建造菜单选择、放置旋转、控制器及无关工具均保持原版。
• 泥土小径： 默认冲刺速度加快10%，冲刺体力消耗减少10%。
• 铺设道路： 默认冲刺速度加快20%，冲刺耐力消耗减少20%。
• 四个百分比均可独立配置，范围从0%到100%。
• 加成仅对在原生地形绘制的路径上冲刺的本地玩家生效。
• 0.18秒的短平滑窗口可防止道路标线小间隙处出现闪烁。
• 耕地、建筑地板、离开地面以及其他非地形表面会立即清除加成。
• 无状态图标、弹窗、音效、游戏内消息、自定义世界状态或服务器要求。

行走、潜行、游泳、跳跃、闪避、攻击、马车、生物、自然地形、耕地和建筑地板均未改动。

Treadwell会乘以Valheim计算出的奔跑速度系数以及最终经过状态效果调整后的冲刺耐力消耗。它不会替换基础数值，也不会绕过奔跑技能、装备、状态效果或全局移动耐力修正。

安装

特雷德韦尔需要 Valheim 的 BepInExPack 5.4.2350.

通过r2modman或Thunderstore Mod Manager安装，或者复制 特雷德韦尔.dll 到：

BepInEx/plugins/Treadwell/Treadwell.dll

想要获得地形控制或移动加成的玩家，需自行在自己的客户端安装Treadwell。无需在服务器端安装，且Treadwell不会同步配置，也不会将自定义模组状态写入世界。

配置

特雷德韦尔正好创建了五个设置， BepInEx/config/com.jstack424.treadwell.cfg:

1. 启用模组 （默认 真)
2. 泥土冲刺速度加成（%） （默认 10)
3. 泥地冲刺耐力消耗降低（%） （默认 10)
4. 铺装路面冲刺速度加成（%） （默认 20)
5. 铺装道路冲刺耐力消耗降低（%） （默认 20)

地形半径特意不添加任何配置设置。每个操作都保留自己独立的仅限当前会话的半径，并初始化为各自经过验证的原版外半径：平整地面3米、小径2米、铺装道路3米。平整地面限制在1–8米；小径和铺装道路限制在1–10米。运行时要求当前工具部件表中存在一组唯一且完整的三笔刷组合，并使用每个操作的精确本地化标识、操作形状、配方指纹以及3/2/3米基准。运行时预制体对象名称仅用于诊断，而非身份判定条件，这修正了当Valheim的实时对象名称不同时对小径的识别。零个、缺失、已更改或有歧义的匹配都会安全失败，且不会改变地形效果。

原版的切石机需求没有改变。特雷德韦尔仍然会检查那个由工作站支持、仅用一块石质铺路砖的配方，作为其窄范围可调半径识别的一部分，但它绝不会移除或替换对制作工作站的需求。

所有百分比均限制为 0–100 并实时读取。总开关会安装或移除特雷德韦尔的隔离Harmony补丁。

如果较早的测试版本创建了配置文件，BepInEx可能会保留其较旧的默认设置。删除 BepInEx/配置/com.jstack424.treadwell.cfg 一次以重新生成当前默认值，或手动设置四个百分比为 10, 10, 20，以及 20.

兼容性与安全性

特雷德韦尔1.0.1使用了基于合约的兼容性门控。瓦尔海姆显示的版本、Unity版本以及已加载的 组装_瓦尔海姆 MVID 仅作为诊断信息记录，并非精确版本阻塞项。客户端与专用服务器程序集，以及兼容的 Valheim 1.0 补丁版本，可能构建标识不同，但 Treadwell 所需的 API 保持一致。

在安装玩法补丁之前，Treadwell 会验证其补丁或调用的每一个必需的 Valheim 方法和重载、匹配的 Harmony 前缀/后缀形态、每一个访问的游戏字段、用于道路发现的 Unity 组件/属性方法，以及预期的部件表、资源、枚举和地形绘制约定。每一个必需的玩法成员都必须解析为恰好一个兼容签名；缺失或有歧义的成员将按失败关闭处理。玩法补丁安装是事务性的。提示的 UI/输入约定和 Harmony 补丁会单独检查并安装：如果该可选表面发生变化或失败，Treadwell 只会跳过或移除其自有的提示，而地形半径玩法仍保持激活。

半径控制仅识别瓦尔海姆中经过验证的语义形状的精确本地化平整地面、铺路和铺装道路操作。预制体对象名称（泥路_v2, 路径_v2，以及 铺砌道路v2) 作为有界诊断信息保留，而非脆弱的身份门控。每个操作必须恰好有一个根 碎片，一个根 地形操作，无传承 地形修正，不旋转，以及已验证的操作/配方形状。Level Ground 是 3 米处的平滑 + 泥土涂装；Pathen 是 2 米处的泥土涂装；Paved Road 是 3 米平滑 + 2.2 米铺装涂装，并带有其由站点支持的一石配方。Treadwell 会缩放单独的放置虚影的 仅限幽灵 在XYZ轴上均匀分布几何体，即使那个原版子物体处于非激活状态。Pathen的可见粒子嵌套在其旋转的4×4×1标记之下，并使用Unity的局部粒子缩放模式，因此Treadwell也会缩放该粒子自身的变换；粒子直接附加到 幽灵专属 不会双重缩放。

在确切的当地时间 玩家放置棋子 呼叫，特雷德韦尔会临时缩放所选预制件，使 地形操作.唤醒 搜索选定的整个区域，然后精确拦截 地形操作.设置 进入副本 地形组件.执行操作在地形所有者解析完操作标识后，临时将所选半径应用到该最终设置对象上。该补丁仅对当前激活的放置位置以及完全匹配原版平地、小径或铺装道路语义形状的情况生效。在地形操作和草地重置完成后，由 Harmony 最终化器恢复最终设置。铺装道路的 2.2:3 涂装与平滑比例保持不变，已禁用的通道绝不会被更改，冲突的第三方修改也绝不会被覆盖。切换工具/操作、关闭输入、场景卸载、插件禁用或任何输入异常都会恢复或清除瞬态状态。

该构建版本仍保持编译状态，并已针对固定的 Valheim 版本进行独立校验。 1.0.14 / Steam 版本 25364309 参考捆绑包。其哈希值和MVID仅用于记录和保护构建来源；它们刻意不与玩家的运行时程序集进行比较。固定的IL验证了Treadwell仍在使用的 terrain、placement、input、movement 和 HUD 契约。Treadwell不再修补需求检查、强制刷新建造可用性，也不再写入任何制作站字段；原版Stonecutter、DLC、自由建造、石头计数、放置、消耗、耐力、耐久度、技能和效果处理均保持不变。

Treadwell 0.1.2 的道路加成以及当时不含 Stonecutter 的 Paved Road 行为已成功通过实地测试。在 0.2.x 测试线中，Alt+滚轮相机缩放隔离已获得正面实地确认。0.2.1 和 0.2.2 的实地测试均显示，Level Ground 的标记可能改变大小，但其实际地形效果仍保持原版半径；Pathen 的实际效果在 0.2.1 中也保持不变。 版本0.2.3已在线确认运行非常良好，包括修正后的实际地形半径路径。0.2.4版本尝试添加原生风格的 Alt + 滚轮 — 调整大小 可发现性提示，但已克隆 替换放置键 在现有的Gamepad父级下。Valheim会为键盘控制隐藏该分支，而Treadwell会为手柄控制隐藏仅键盘提示，因此它永远无法变为可见。版本0.2.5验证了同级Gamepad/Keyboard布局契约，并将其隔离克隆附加到Keyboard容器，而未更改Valheim的源标签，也未从HUD重新验证游戏玩法；其 Alt + 滚轮 — 调整大小 提示随后在活动键盘行中得到了实时确认。1.0.0 版本提升了同一套经实时批准的游戏玩法和 UI 行为。1.0.1 版本移除了无切石机选项及其关联的运行时代码，因为该选项被发现与一个已报告并复现的物品栏变更性能回归问题有关；此确切包仍需实时验证。地形 RPC 携带的是操作预制体标识，而非自定义半径值，因此未安装模组的远程地形所有者无法接收自定义半径；多人/远程所有者行为仍明确未经验证。

开发

私有 Valheim 和 BepInEx 程序集始终保持未跟踪状态，且永远不会被打包。

./scripts/build.sh ./scripts/test-package.sh

该构建执行锁定还原、警告即错误的发布编译、纯行为测试（包括精确契约的接受/拒绝和事务回滚）、针对固定来源程序集的独立程序集契约测试、引用指纹检查、仓库检查，以及精确的五文件包审计。

来源、问题与许可

• 源与问题追踪器： https://github.com/JStack424/Treadwell
• 许可证： 麻省理工学院