全面锄头重做：多步撤销/重做、高度锁定、即时平整、样条道路雕刻、柔化/恢复、清除杂物、服务器同步与专用服务器支持、9种语言，以及生存模式平衡。

智能锄头

为瓦尔海姆的锄头带来全面而精准的地形编辑重制。SmarterHoe为你提供一套专业的 terraforming 工具——从激光般平整的高原整平、多路径样条道路开凿，到完整的多步撤销/重做、3D预览、9种语言本地化，以及服务器权威的专用服务器同步——同时完全保持适合生存玩法的平衡性。

---

功能

⏪ 多步撤销与重做系统（[Alt+Z] / [Alt+Y])

犯了个错误，挖得太深，或者把山坡铲得太平了？按 [Alt+Z] （或 [Ctrl+Z]）逐步撤销之前的地形更改。按 [Alt+Y] （或 Ctrl+Y / [Shift+Alt+Z]) 重做。

• 通用工具支持：适用于海拔平整、瞬间台地、软化、恢复自然、样条坡道、原版抬升地形、泥路、铺石路和耕种。
• 连续扫描分组按住左键拖动来平整或铺设时，会将整个连续笔画合并为一个原子的撤销条目。
• 智能路径点后退：当坡道航点处于激活状态时，按下撤销键会先自动回退最近的一个航点，然后再还原地形。
• 完整纹理与草地恢复：撤销操作会完全恢复泥土、草地和石头的绘制遮罩，并实时同步杂物。

🔒 高度锁定 — 激光平整地面

按下 [L] 用于切换锁定高度。此后每次锄头点击都会将地形整平到该精确高度，确保在丘陵和斜坡上都能获得完全平坦的表面。

• 对齐建筑楼层：瞄准任何已放置的木质或石质地板，然后按下 鼠标中键 将锁定的高度吸附到该楼层的精确高度。
• 长按连续调节仰角按住 上一页 或 [PageDown] 平滑快速地调整高度，无需连按按钮。在连续移动开始前设有短暂延迟，以防止单次点按时的意外过冲。按住 Shift 获得5倍速度加成。

⬛ 一键高原 —— 单击剃刀般平整压平

一键整平画笔区域内所有地形至光标正下方高度的专用整平工具，无需多次点击逐级整平，也不会留下阶梯状棱脊。

〰️ 平滑坡道 — 多路径道路自动雕刻器

放置路径点（[K]) 穿越崎岖地形，规划出山间小径或公路。按下 [H] 使用Catmull-Rom样条插值，立即自动在所有路径点之间开凿出一条平滑且有坡度的道路走廊。

• 购物车友好度颜色指南：实时3D脊柱动态显示坡度陡峭程度：
  • 绿≤20° — 适合推车（✓）
  • 黄色：20–25° — 手推车陡坡 (!)
  • 红色: >25° — 手推车太难推 (✗)
• Shift+雕琢: 保留 Shift 按住 [H] 直接在铺好的鹅卵石路面自动雕刻整条道路。

🔄 真实方形与圆形笔刷（定向变形）

• 按下 [G] 在圆形和方形笔刷形状之间切换。
• 真·旋转方块对齐：方形笔刷可通过鼠标滚轮或方向键平滑旋转（[左箭头] / [右箭头]修复了原版英灵神殿中轴对齐菱形扭曲的问题，使抬高和整平的地形与黄色指示框对齐。
• 按下 [主页] 立即将方块旋转重置回0°（北）。

🌀 软化地形

将尖锐的山脊和悬崖褶皱柔和地融入自然流畅的过渡，而不会将地形压平为平面。

↩️ 恢复地形

将笔刷半径内的地形重置为原始的未修改世界生成状态——清除所有挖掘、平整增量和涂刷修改。

🪓 清理碎片

立即移除锄头范围内的树木、原木、树桩、岩石、巨石和灌木。在平衡生存模式下，树木需要斧头，岩石需要镐——防止跳过进度，同时免去手动清理的繁琐。

📐 扩展触及范围与绕过8米限制

• 扩展锄头范围（默认20米，可配置5米–50米）：无需一直向前跑就能轻松改造地形；卸下后自动恢复原版触及距离。
• 绕过8米高度限制移除《英灵神殿》中±8米的严格高度限制（允许超出游戏限制 = true)，让你能够填平深谷或建造高耸的山地城堡，上限可配置（默认：50米）。

🔼 可调节升高高度和3D立体预览

• 按 [E] 进入 高度模式鼠标滚轮可调整单击抬升高度（每次点击0.05米至8.0米）。
• 按下 [Q] 进入 区域模式；滚动鼠标滚轮调整笔刷半径（0.5米至20米）。
• 3D 半透明预览：显示一个实时3D半透明圆柱体（当方形笔刷激活时为旋转立方体框），在点击前显示确切的抬升体积和高度，并按可达范围进行颜色编码。
• 镜头缩放抑制：防止在滚动调整笔刷半径或提升高度时第三人称相机跳变。

🌐 多语言本地化（9种语言 + 自动检测）

自动检测你当前的英灵神殿语言（语言 = "自动"）。自定义工具名称、悬停描述、购物车坡度评级和HUD通知均已原生翻译为： 英语, 德语, 法语, 西班牙语, 俄语, 简体中文, 葡萄牙语（巴西）, 抛光，和 瑞典语.

🖥️ 专用服务器支持与服务器同步

• 完全集成于 服务器同步 用于专用服务器。
• 服务器权威：服务器所有者可以强制执行 成本模式 = 均衡生存、触及限制、最大半径、石头/耐力消耗、站点检查以及高度限制在所有连接的客户端之间同步。
• 客户端可选且原版服务器兼容（模组必需 = 假):
  • 连接到原版或非模组服务器时不会被踢出或拒绝。
  • 原版玩家可以加入模组服务器，不会被拒绝。
• 服务器锁定执行：当被服务器锁定时，客户端无法通过以下方式绕过生存费用： [B] （显示屏幕提示和HUD锁定标记）。管理员在 管理员列表.txt 保持豁免，并可实时调整设置。

---

笔刷与高度选项

• 圆形/方形切换 — 按下 [G] 在圆形和方形笔刷几何形状之间切换。方形笔刷会随你的玩家方向旋转。
• 半径调整 — 按下 [Q] 并滚动鼠标滚轮（或按住 [Alt] + 滚动）调整笔刷半径（0.5米 – 20米）。
• 升高高度调节 — 按 [E] 并滚动鼠标滚轮（或按住 [Alt+Shift] + 滚动）调整抬高增量（0.05米 – 8.0米）。
• 坡道宽度调节 — 按 [ / ] 调整道路走廊宽度（1米 – 20米）。
• 香草铺装半径 — 香草 泥路, 石板路，以及 培养 碎片会按当前画笔半径缩放。

---

平衡生存模式与动态资源缩放

智能锄头是 默认平衡 用于生存玩法——所有地形操作都会像原版建造一样真实消耗资源和耐力：

消耗	规则
动态石（升高地面）	与两者成比例缩放 笔刷区域 （半径，圆形与方形）以及 提升高度 （相对于原版0.5米基准）。隆起一座高耸的4米高台，成本自然比0.5米的小土丘要高得多。
动态石（铺装路）	与铺设的圆石表面积成正比。
实时HUD同步	建造菜单需求框动态显示所需的确切石头数量（拥有 / 需要不足时会闪红光。石材不够时，放置虚影和3D预览也会变红。
体力	每次操作消耗精力；精力耗尽时清理会在清扫中途停止。
工具耐久度	锄头和工具会磨损；损坏的工具会阻碍操作。
工作台邻近	提升土地所需；铺设圆石需要切石机（可在服务器配置中切换）。
工具需求	斧头清理树木，镐子清理岩石（使用“清理杂物”时）。

🛠️ 自由建造创造模式（[B])

按 [B] 随时切换至 自由建造创造模式:

• 0 资源：无需任何石头或材料，也不会从你的物品栏中扣除。
• 0 制作站在没有附近工作台或石匠台的情况下，可随处进行地形改造。
• 0 耐久与体力：无限地形改造，无耐力消耗或工具损坏。
• 整洁HUD：在自由建造模式下，建造栏中的石头需求会自动消失。服务器所有者可通过ServerSync将消耗模式锁定为均衡生存。

---

控制与快捷键摘要

快捷键	动作	笔记
[Alt+Z] / [Ctrl+Z]	撤销地形操作	撤销上次操作（或退回上一个坡道航点）
[Alt+Y] / Ctrl+Y	重做地形操作	重做上次撤销的地形修改（也可 Alt+Shift+Z)
[Q]	选择区域模式	鼠标滚轮滚动可调整笔刷半径
[E]	选择身高模式	鼠标滚轮滚动可调整抬升高度（0.05米 – 8.0米）
[L]	切换高度锁定	将地形平整至固定高度
鼠标中键	快速高度锁定	瞄准任意已放置的部件以匹配其地板高度
上一页 / [PageDown]	调整锁定高度	点击或 按住 用于快速顺畅移动
[Shift] + [PgUp/PgDn]	5倍快速高度调校	将海拔变化率乘以5倍
K	放置坡道航点	放置点 A、B、C……（完成后清除）
[H]	自动雕刻坡道	沿样条走廊雕刻。 按住 Shift 用于铺石路面
退格	撤销上一个航点	移除最近的路径点
[ / ]	调整坡道宽度	更改道路走廊宽度（1米 – 20米）
Alt + [ / ]	调整笔刷半径	改变升级/笔刷半径（同时 Alt + 滚轮)
[P]	循环坡道涂装模式	圆石，泥土，保留草地，耕地，匹配工具
[G]	切换笔刷形状	在圆形和正方形之间切换
鼠标滚轮	旋转方形画笔	激活时旋转方形笔刷（除非按住 Alt 调整大小）
[左箭头]	向左旋转方块	逆时针旋转方形笔刷
右箭头	向右旋转方块	顺时针旋转方形笔刷
[主页]	重置方形旋转	将方形旋转重置为0°（北）
[B]	切换消耗模式	在平衡生存和自由建造之间切换
[U]	恢复地形	将地形恢复为原始世界生成状态

---

控制台命令（F5)

使用以下方式打开英灵神殿游戏内控制台 F5 （需要 -console Steam 启动选项）用于即时地形工具：

指令	参数	描述
重置地形	[radius=10]	将半径内所有挖掘/平整恢复为自然生成状态（支持撤销）
移除林业	[radius=10]	清除半径内的树木、原木、树桩和灌木
清除杂物	[radius=10]	清除半径内的岩石、巨石和障碍物
智能锄头_撤销	无	撤销上一次地形修改
聪明的hoe_重做	无	重做上一次撤销的地形修改

---

配置

配置文件： BepInEx/配置/com.jubaroo.smarterhoe.cfg

所有设置均可在游戏内使用BepInEx配置管理器进行配置（F1），或直接编辑配置文件。连接到运行 SmarterHoe 的专用服务器时，同步设置由服务器强制执行：

设置	默认	同步了吗？	描述
锁定配置	真	是	将配置锁定为服务器权威；只有服务器管理员才能修改同步设置
消耗模式	平衡生存	是	资源模式： 均衡生存 （消耗开启）或 自由建造 (创造模式)
豪瑞奇	20	是	装备锄头时的最大放置范围（米）
最大笔刷半径	20	是	平整、柔化和清除工具的最大允许笔刷半径（米）
允许超出游戏限制	真	是	允许进行超出《英灵神殿》标准±8米高度限制的地形改造
最大地形高度差	50	是	与自然地形的最大海拔差（米）
默认举起高度	0.5	不	每次提升操作增加的默认高度（米）
提高滚动步长	0.5	不	调整高度时鼠标滚轮每步的高度增量
最低加注	0.05	是	最小可选抬高高度（米）
最大提升	8.0	是	可选最大加注高度（米）
抑制相机缩放	真	不	调整锄头半径或高度时防止镜头缩放
抑制缩放模式	正在调整	否	调整中 （热键/滚动时）， 始终带锄，或 禁用
启用上升圆柱预览	真	否	显示带有可达范围颜色编码的3D半透明预览圆柱
语言	自动	不	游戏内语言（自动 检测游戏语言，或 英语, 德语, 法语, 西班牙语, 俄语, 中文, 葡萄牙语, 抛光, 瑞典语)
启用撤销	真	是	启用多步地形撤销与重做
最大撤销步数	15	是	撤销历史快照的最大存储数量（1 到 50）
撤销键	Z	否	触发撤销的快捷键
重做键	Y	不	触发重做的快捷键
撤销修正	Alt或Control	不	需要修饰键（AltOrControl, 左Alt, 左Ctrl, 无)
后退一步并撤销按键	真	否	撤销键在激活时将路径点回退到坡道位置
高度锁定键	L	不	切换高度锁定
高度对齐键	鼠标2	否	将锁定高度吸附到目标部件（鼠标中键）
高度步进	0.1	不	每按 PageUp/PageDown 调整的米数（按住 Shift 为 5 倍）
高度保持延迟	0.35	否	按住PageUp/PageDown键时，开始连续调整前的延迟秒数
高度重复率	0.05	不	按住 PageUp/PageDown 时每次调整之间的秒数
立即压平	真	是	将笔刷半径内100%的地形顶点立即提升至精确目标高度
立即压平原版	假	是	为原版锄头的“整平地面”工具应用一键即时整平功能
压平边缘边距	0.0	是	用于平整的边缘混合羽化边距，单位米
每立方米石头	0.25	是	在生存模式中每提升一立方米地形所需的石头消耗
每块铺石消耗的石头	0.03	是	生存模式下每平方米鹅卵石铺路的石头消耗
需要制作站	真	是	需要工作台来堆土，需要石匠来铺石
需要工具才能清除残骸	真	是	清除杂物时，砍树需要斧头，采石需要镐子
清除时掉落资源	假	是	清理杂物时掉落木材/石头，而非直接删除
动态坡面着色	真实	否	按坡度对坡道指南针进行颜色编码，以显示是否适合推车
方形旋转模式	滚轮和按钮	否	滚轮和按键, 仅按钮，或 仅滚轮
方块旋转角度	22.5	不	每次点击/步进时方形笔刷旋转的角度
向左旋转方块键	左箭头	不	左旋转方形笔刷的快捷键
右旋方块键	右箭头	不	按此键向右旋转方形笔刷
重置方块旋转按键	主页	不	重置方形旋转至0°（北）的按键

---

专用服务器支持与服务器同步

智能锄头功能无缝 服务器同步 与完全服务器权威配置的集成：

• 服务器权威服务器所有者可以在专用服务器上安装SmarterHoe，对所有连接的玩家强制执行平衡规则：
  • 执行 成本模式 = 平衡生存 防止玩家切换至自由建造创造模式（【B】 开关在带有屏幕提示的客户端上被锁定。
  • 强制执行触及范围限制（锄头范围），最大笔刷半径（最大笔刷半径），最大地形高程差（最大地形差）、耐力/耐久消耗、站点要求（需要制作站），以及工具需求（需要工具清理残骸）。
  • 服务器管理员列于 管理员列表.txt 自动豁免，并可实时调整设置，即时同步至所有已连接的客户端。
• 客户端可选与原生服务器兼容性（所需模组 = false):
  • 连接到原版/无模组服务器：只要你的客户端安装了SmarterHoe，你就可以安全地加入任何原版或社区服务器。你将会 永不 被踢出、断开连接或拒绝；你的本地客户端设置会正常生效。
  • 原版玩家在模组服务器上如果服务器管理员在专用服务器上安装了SmarterHoe，没有安装SmarterHoe的玩家仍然可以加入服务器，不会被拒绝。

---

兼容性

• 多人游戏 —地形操作会修改瓦尔海姆原生的 地形组件 高度图和ZDO网络；所有玩家实时看到变化。
• 专用服务器 — 在无头优化下获得全面支持（图形设备类型.空) 以及实时服务器权威配置同步。
• 客户端可选 — 在原生服务器上作为仅客户端模组运行，或在专用服务器上作为强制服务端模组运行。
• 已知冲突 — 同样会修补的模组 玩家.更新放置幽灵 或者深度覆盖锄头部件行为可能会产生冲突。

---

制作人员

由……建造 朱巴鲁.
受更广泛的英灵神殿模组社区启发，对英灵神殿地形系统的研究。