锄头和耕耘机的土地改造：笔刷大小和形状、精确高度、坡道和道路、撤销、费用、高度限制、结界、铲子。服务器同步。服务器端也需要安装。

大地工匠

为《英灵神殿》的锄头和耕耘机添加地形改造功能。在游戏自带的建造菜单中即可调整笔刷大小、选择形状与边缘、精确平整至指定高度、按精确数值升降、平滑、涂抹、重置、修建坡道与弯曲道路，以及撤销操作。费用、高度限制、领地保护和管理员规则均由服务器设定。所有玩法设置均可同步并可锁定，所有按键与显示选项均为每位玩家独立配置，配置文件及五个YAML文件均支持热重载。

服务器和每个客户端都需要。 拥有一块地面的机器会对其应用EarthWright的编辑，而超出游戏±8米范围被抬升或挖低的地面，仅在安装了EarthWright的地方才能正确显示。

画笔

• 尺寸：Alt + 鼠标滚轮，或 ] / [ （按住Ctrl进行更大步进）。默认范围为0.5到20米；由服务器按条目设定范围， 地球工匠.笔刷.yml 游戏自身的条目以各自的大小开始，并且每个条目都会记住自己的大小。绘制会随画笔而增大。大小倍数、随技能提升的上限以及每级工具的上限都是可选项。
• 滚轮调整的数值: B 逐步调整大小、数量（增加或减少数量、等级步进或平滑强度）、边缘硬度、旋转、深度或内部尺寸以及目标高度。HUD会高亮显示当前选中的项。
• 形状: N 循环切换圆形、正方形、矩形、圆环和边框。方向键可将其旋转22.5°， 主页 将其转回北方。方格是真实世界中的正方形，而非游戏里的菱形。
• 边缘：从柔边（效果从中心逐渐消退）到硬边（直至边缘都保持完整效果）。方形隆起上的柔边会形成斜角，而非陡壁。
• 网格模式 (I)：画笔会以硬边缘吸附到整米；按住 Z 仅在按住时快速移动。 瞄准边缘 (O）：准星标记的是该区域的近端边缘，而不是其中心。
• 按住鼠标键持续涂抹（起始延迟和速率为可调设置）。用滚轮调节时镜头不会缩放。

目标高度（升级到哪一级）

• 默认情况下脚下移动，和游戏一样；按住 Shift 键则以准星下的地面为准。
• K 锁定当前高度； 上一页 / 下一页 将其移动 0.1 米（Shift：0.5 米）； 结束 回到你脚下。选择目标高度时 B 以0.25米为步长设置精确高度（Ctrl：2米）。
• Y 循环步法，瞄准地面并 继续平淡：光标旁边已整平地面的高度，这样新笔画会延伸你已建造的平台（当两个平台高度不一致时回退到准星位置）。
• 鼠标中键可复制你所瞄准的地板部件高度。
• HUD会显示目标高度及其来源。点击地面旁的岩石或悬崖依然有效：笔刷会落到其后面的地形上。

行动

• 等级 三种样式，循环切换 L：轻松（类似游戏，每次点击至多一小步）、步进（更大的一步，最多1000米）和瞬间（一键即达平坦高台）。 F9 使选定“Level”或“Raise”的地形瞬间形成坚硬边缘的高原。
• 提升 和 降低 按精确数值提升（默认0.05至8米）；重复提升累计至提升上限。
• 平滑 将隆起部分整平，而不压平地面。
• 油漆: P 循环切换条目自身的涂装、泥土、铺装、耕地、草地、生物群系原始地面、草地密度、清除草地和保留（更改高度，保留涂装）。
• 重置：重置条目， U 用于画笔区域或 Shift + U 你周围的地面及其涂装会恢复成世界本来的样子。重置不会移除建筑、树木或岩石，并会跳过建筑下方的地面。
• 撤销和重做: Ctrl + Z / Ctrl + Y，默认15步。按住笔画算一步；斜坡、道路、重置和涂装都涵盖在内。费用不予退还。登出时历史记录会被清除。

构建菜单项

游戏中的平整地面、抬高地面、小径、铺装道路、开垦和补植都使用笔刷。EarthWright 新增：

• 锄头：低地、平滑、涂抹、重置、坡道、道路、破土者（一击完成清理、平整和铺设）、清除物体（除非服务器允许清理，否则关闭）以及地形改造（管理员：可超出高度限制进行平整）。
• 修仙者：耕种（不改变高度）和连根拔起（清除灌木丛中的野果、蘑菇、树枝和石头）。
• 锄头和耕耘机菜单获得了游戏完整的建造菜单，带有搜索、最近使用和收藏功能。每个条目都可以关闭，每个条目的描述会列出所有与其配合使用的按键，按照你所绑定的设置。任何控制台命令都可以通过以下方式成为菜单条目： EarthWright.Entries.yml.

坡道和道路

• 坡道：点击起点，点击终点，用画笔大小设置宽度（或横向移动光标），再次点击即可建造。 N 循环切换轮廓：直线、软连接、软端点、S形曲线。按住 Ctrl 仅加宽一侧，按住 Alt 将端点融入地面。 J 立刻从你脚下到准星之间架起一条斜坡。
• 道路: 点击路径点，道路会蜿蜒穿过它们； H 雕刻它， Shift + H 将其铺平。
• 预览会按坡度给轨道车上色（20°以内为绿色，25°以内为黄色，更陡为红色），当坡道过陡、过长或超出高度限制时会变为红色。HUD会显示长度、高度差、宽度、坡度以及已变化的点数。
• 退格或者按撤销键，先移除最后一个点。

预览与HUD

• 笔刷轮廓贴合地面；标记显示所有将发生变化的点（升高、降低、受限制约束）；半透明体块显示地面至目标高度的范围；区域内的建筑会高亮显示。
• 准星旁：大小、形状、边缘、数量、样式、涂装、目标高度和来源、消耗，以及光标下的地块和高度。当服务器锁定设置时，会显示一个徽章。
• F8 在地面上绘制世界网格。 F6 （或按 Esc 菜单中的 EarthWright 按钮）会打开一个面板，可输入精确数值、使用抬升预设（1×2、5×2、5×3、8×3）、撤销和重做，管理员还可使用保护设置。
• 颜色、大小以及显示的每个部分都是个人设置。锄头的灰尘效果可以关闭。

花费

默认原版。服务器可以设置耐力（关闭、固定、随画笔缩放）、工具磨损、材料（随画笔缩放，按条目分别设置 EarthWright.Costs.yml，外加每次挥动一个物品），所需的工作台（无需石匠台即可铺设；除非服务器要求，否则破地者不需要任何工作台），每升高一立方米和每铺设一平方米所需的石头，以及一个冷却时间。自由建造（F7) 默认情况下仅供管理员使用。HUD 会显示一次笔触消耗多少以及你拥有多少，不足时显示为红色。重置和撤销始终免费；管理员的 Terraform 条目消耗体力和磨损，但不消耗石头。

高度限制

游戏允许从世界地面向上8米和向下8米。EarthWright会针对每个生物群系分别设置这两个限制（0.5到512米），在 地球工匠.限制.yml，并将它们也用于镐子。管理员可以更进一步（管理员限制，并持有 右 Alt 点击时）。可选：平缓斜坡（挖掘也会降低周围区域，隆起则抬升周围区域），以及严格模式，在该模式下挖掘限制仅作用于矿石、埋藏宝藏和焦油附近时才会解除。 新限制 显示你所在位置的界限。

保护

• 结界会在整个笔刷范围内检查，在你的机器上检查一次，再在地面所属的机器上检查一次。
• 无法在禁建区域（商人、首领祭坛）或地下城内进行地形改造。
• 服务器可以将地形工具开放给所有人、仅限管理员或任何人都不行，锁定所有地形编辑（管理员可绕过，工具可豁免，包括镐子），在敌对生物追猎你时拒绝编辑，并将地形改造限制在管理员区域（添加新区域 <name> <radius> [player], 新区域列表, 移除区域 <name>）。
• 清除物体和连根拔起也适用相同的规则。

工具

当装备地形工具时：覆盖范围达到20米（5到50），工具上有一盏所有人都能看到的灯（颜色由你决定），移动速度提升，左手始终持有火把。锄头和耕耘机升级到6级。在土路上冲刺速度提升10%且消耗更低，在铺装道路上提升20%。种子可以对齐到网格（I 选择种子后），并且可以允许培育者在游戏禁止的地面上进行。

控制台命令

新帮助 将它们列出。 咦，开 / 关闭 为你切换EarthWright（在聊天中也输入为 关闭）。 重置半径, 撤销, 重新做, 新历史, ew snapshot save|restore|list|delete <name> [radius], 新限制, 新区域……, 新语言编写|重新加载, 重新装填 （管理员）。清理中： 新林业 [半径], 新残骸 [radius]，以及为管理员 新碎片 [radius] 和 新地形 <op> ... (等级，提升，降低，最小，最大，范围，偏移，斜率，移除，重置，绘制；用于筛选部分点、跳过建筑下方的地面，以及包含或忽略对象的过滤器)。 新地形帮助 列出选项。

文件

• 奶白队。大地工匠.cfg：每个设置项，按上述章节编号。已热重载。
• EarthWright.Brushes.yml （每项笔刷大小） EarthWright.Costs.yml （每条费用）， EarthWright.Entries.yml （自定义菜单项）， 地球工匠.限制.yml （每个生物群系限制）， EarthWright.Zones.yml （管理员区域，由服务器保留）。从服务器热重载并同步。
• 地球工匠.语言.<语言>.yml：翻译。 新语言写作 写下英文模板。

服务器设置

与 锁定配置 开启时（默认），所有玩家都使用服务器的数值且无法更改；服务器管理员仍可在游戏内修改。按键、颜色和显示选项则始终由你自己决定。

如何安装

1. 安装 Valheim 的 BepInEx.
2. 在服务器和每个客户端上安装此模组。

手动安装时，请将 地球工匠.dll 进入 BepInEx/插件在填高或挖深超过8米后，请保留“地球之匠”模组：否则游戏会将那片地面钳制在其自身极限范围内绘制。

建筑

要求：.NET SDK 8、已安装 BepInEx 的 Valheim，以及 瓦尔海姆模组库 此文件夹旁边的文件夹。 pack.ps1 构建模组并在以下位置创建 Thunderstore 压缩包： 雷暴商店/.

dotnet build EarthWright/EarthWright.csproj -c Release

错误报告和功能建议

源代码是开放的，可在商店页面链接的仓库中查看（网站地址 在 thunderstore/manifest.json): https://github.com/geraldjglasgow/ValheimMods.发现漏洞或想添加功能？请在此提交问题： https://github.com/geraldjglasgow/ValheimMods/issues 并注明模组名称、版本以及发生了什么。

鸣谢

• BepInEx 和 Harmony 团队，感谢你们为所有英灵神殿模组奠定的工具基础。
• Iron Gate Studio，为《英灵神殿》打造。
• Thunderstore，感谢托管此页面。
• 献给瓦尔海姆模组社区，感谢你们辛勤付出与奉献，让一款本已出色的游戏不断焕发新生。
• 每一位坚持开源自己模组的作者，让其他人得以协作、学习并在此基础上继续开发。

许可

GNU通用公共许可证v3.0（GPL-3.0）。你可以自由使用、研究、分享和修改它，任何基于它构建并分发的内容都必须携带相同的自由，并在相同许可证下发布，附带源代码。详见 许可证 完整条款请查看文件。