贾夫纳

用锄头平整土地时，会继续平整它接触到的平地，而不是追随你的准星，你的制作技能决定了一次挥动覆盖多少地面。

贾夫纳 是古诺尔斯语，意为使平坦、使相等。

为什么

用锄头整平一大片区域非常痛苦，值得仔细想想原因，因为显而易见的答案是错的。问题不在于工具太小，而在于工具对你想要的目标高度没有固定概念。

锄头的整平功能会把工具下方的每个点都拉向放置虚影所在的高度，而虚影会停留在你的准星最后接触地面的位置。所以参考高度是跟着视角走的。挥一下，走两步，再挥一下，两次挥动覆盖的那条地面就会被拉向两个不同的高度。你没法靠瞄准来解决这个问题，因为移动的不是你的准星，而是目标点。这也是为什么你越是在边缘附近小心翼翼地操作，波纹就越严重：每一次修正都是在另一个高度上又挥了一下。

贾夫纳给秋千提供了一个固定的参照平面，而游戏其实一直都保留着这个数据。每个区域的地形数据在每个网格点上都带有一个标记，意思是“某个地形操作已经改动过这里”，它会随世界一同保存并与所有人共享。所以秋千可以查看它即将覆盖的地面，找到之前某次秋千已经塑造过的部分，并使用那个高度，而不是你准星所指的高度。平整会从你开始操作的地方以同一高度向外扩展，并且在你的下一次游戏会话中、在另一个玩家的锄头下，仍会继续扩展。

一次荡跃如果没有覆盖到之前升过的任何高度，就完全不会受到影响，这也是为什么你仍能在新的高度开始新的平台：远离旧的平台再荡跃。

它的作用

• 水平挥击会延续它所接触的平面。 若覆盖到已平整的地面，则沿用该高度。若完全未覆盖，则与原始版本行为一致。
• 它拒绝而非猜测。 当两个不同高度的平台在同一个秋千下交汇时，它把决定权交还给你的准星，而不是将它们平均成一个斜坡。
• 你可以保持一个高度。 按左Alt键可将准星所指目标固定，此后无论你站在何处，每次挥击都会朝它压平，直到再次按下该键。
• 低洼地被石头垫高。 当铲子无法将地面抬升至所需高度时，挥动会直接将整个圆形区域抬升到你的高度，你的背包会按照铲子“抬升地面”的费率，为铲子本无法完成的工作付出代价。它会在圆形边缘留下一个台阶，直到你在旁边挥动为止。和“抬升地面”一样，它需要附近有工作台。
• 制作能力提升，触及范围随之扩大。 下方无任何关于制作25级的内容，制作60级时半径增至6米，而锄头本身为3米。绝不打折：每次挥动消耗的耐力与原版完全相同。
• 只有你自己的挥杆会被改变。 任何其他东西塑造的地面，无论是地点、其他模组、开发工具包平整的地面，还是未安装Jafna的玩家所塑造的地面，都会完全按照原版方式塑造。
• 无法使用的守护会阻碍整个挥击范围，而不仅仅是其中心。
• 建造面板显示这些数字，在十三个固定行中，其数量和顺序永不改变：挥杆对地面做了什么、它将使用的高度以及该高度从何而来，以及抬高低处地面需要付出什么代价，还有是否开启了石料填充。参见下方的构建面板。
• 没有新的预制件、物品、配方或存档数据。用Jafna游玩的世界就是普通世界，你所塑造的地面也由原版游戏自身的机制所塑造。

建造面板

数值放在锄头的建造提示框里，位于该部件自身描述的下方，它们所构成的框始终是同一尺寸。提示框会根据自身文本调整大小，所以一个会在挥动不当时多出警告、在挥动良好时减少价格的读数，会随着准星移动而改变框的大小，而在工作速度下这是无法阅读的。因此每种状态都写入相同的行，放在相同的位置，而无内容可写的行则保留一个破折号：

全部清空那个警告槽位，有内容要说时显示红色 地面 最高抬升：1.20米 秋千下方地面最多升高 最低下降：0.80米 最多下降 整平范围6.0米 (制作52) 高度 准星：5.40米 本秋千：5.00米 取自：平坦地面或你的准星，或按住直到你按下的键 消耗 石头：携带20，需要14 石制工作台：范围内 石头填充：开启，J键关闭

警告槽位是就地替换的，从不新增，并按以下顺序显示一件事：你无法使用的结界、超过八米限制的地面、附近没有工作台、然后是石头太少。下方的行说明其余内容。每行都以一个随你环顾四周而变动的数值结尾，因此它之后的内容不会移位。没有一行比框更长，所以没有一行会折到第二行，而原本会（价格中有多种物品、更长的语言）的一行会被截断 .. 而非被允许。 显示读数 将其全部关闭。

面板仅在其显示内容发生变化时重建（最近厘米瞄准、触及范围、价格、背包、石料填充开关、自动提升、语言），而非每帧重建，物品名称仅按语言查找一次。

贾夫纳读数 这是一个开发命令，用于控制台，并且有意包含在构建版本中，以便测试场景可以针对它运行。它只具有读取功能：它会打印面板绘制了多少行、是否有任何行发生了换行或被截断，以及各行是否包含破折号。它不是作弊命令，也不需要开启开发者命令。你没有任何理由去输入它。

占据高地

继续从地面自身给出“这块地面应该是什么高度”的平直答案。大多数时候这是对的，但从来不是绝对可靠，而游玩不到一小时就出现了两种它无法解决的情况：你旁边较高的平台会截获你原本瞄向更低处的挥击，而一次挥击跨越区域边界时，每个区域会各自依据自己那半边覆盖范围来判定。

两者都是模组在猜测你已有的意图，所以你可以直接说明。有了升级工具后，按 左 Alt 准星下方的高度会保持锁定。无论走到哪里、瞄准哪里，每次挥动都会让地面向那个数值缓移，直到你再次按下。开启期间，无需搜寻，也无需猜测。

面板的“取自”行显示 按住左Alt键 只要它还在生效。这个措辞是刻意的：这个功能唯一可能导致的错误就是忘记它开着，而一行告诉你如何停止的提示不会被当成装饰。在该行中，超过14个字符的键名会被截断为14个，以便该行保持在框内。

按键是在你松开时计数，而且只有单独按下该键时才会触发。如果按下期间按了其他键或鼠标键，或者在松开前游戏窗口失去焦点，就不会触发。这是为了适配 Alt+Tab。切换窗口时，游戏仍保持焦点的情况下会先按下 Alt，而第一个版本是在按键按下的瞬间就触发，导致你手里拿着整平工具切出去时就会锁定一个高度，切回来后它仍然保持开启。锁定的高度仍然是在按下时获取的，而不是在松开时。

保持离地一定高度并挥动，就能一路抬高它，对石头而言，只要高度在世界生成地面以上八米以内都行。下一节会讲代价。保持在低于地面约一米以上的位置，地面仍会停住不延伸：保持32米，站在34米，它就会降到约33米，不再继续。锄头只能挖一米，在它之前抬高的地面上能挖两米，而挖掘是镐子的活。

保持的高度不会在登出后保留。回来时，荡着荡着，看着地面朝你昨天设下的某个数字逼近，而你已记不清当初为何要设这个数——屏幕上没有任何变化来提醒你——这比重新设一遍更坑人。

左Alt也是原版的替代放置键，这对地形工具有一定意义。如果你在使用时放置虚影开始表现异常，请移动 按住按键 变成属于它自己的东西。服务器永远不会接管按键绑定，所以无论主机运行什么，它始终属于你。

提升低地，代价几何

锄头的整平功能每次最多将每个点移动一米。它会将该点逐渐移向挥动所瞄准的高度，同时累计已移动的总量，一旦总量达到一米便停止。只有抬高地面才会重新清零该总量。因此，过去若挥动瞄准的高度远高于地面，地面只会被抬高最多一米，之后无论挥动多少次都不再有变化，而面板却一直显示着地面从未达到的高度。

现在，当锄头的米数够不到比你脚下更低的地面时，一次挥动就能把整个圆圈内低于你身高的地面直接抬升到你的高度，代价是消耗你背包里的石头。站在32米高度，保持34米高度并挥动，那么这一次挥动中，圆圈内所有低于34米的地面都会变成34米，石头从你的背包中扣除。高于你身高的地面依然像往常一样，由锄头免费削低。

这就留下了一个位于圆形边缘的台阶，其高度恰好等于该处地面的低陷程度。你下一次在它旁边挥锄需要消耗石料，这一挥会将平坦地面延伸过去，从而消除这个台阶。不到一米的台阶在锄头免费整平的范围内，所以在其旁边进行一次普通挥锄，就会把它顺势融入锄头通常形成的坡度中。这就是其中的取舍，而且是有意为之的。锄头会把地面朝着你的高度逐渐整平，而不是直接设定高度：挥锄正中最深，越往外越浅，到了边缘就完全没有效果。消耗石料的另一种方式，就是顺应这种渐变，一次挥锄只整平中间部分，然后在接下来的几次挥锄中逐渐向外推进。一次性整平整个圆形更快，而那个台阶就是为此付出的代价。

一次付费挥击比顺势而为的挥击消耗更多原石，因为它一次就完成了后者需要好几次挥击才能做到的事，但最终消耗的地面代价是一样的。每个点都会先免费推进一米，之后的路程才需要付费，无论需要挥击多少次才能到达。在地面低于你身高两米的情况下，以锄头自身能达到的距离挥击一次大约消耗7原石，而横跨12米的一次挥击大约消耗27原石。

锄头免费挥动一次的范围若能覆盖其中每一点，该处便完全按锄头作业后的原样保留，平整效果一并保留，且不消耗任何资源。锄头只需挥动几次就能自行处理完那片土地，若为此收费，则普通平整土地也得耗费石料。平整后的顶面是付费才有的效果，免费锄地不会产生。

有两种情况会使某个点不被填平，此时它只会获得锄头自身自由、缓和的移动效果，且不消耗任何资源。游戏从不允许地面高出世界原始高度八米以上，因此低于你当前高度超过八米的地面，无论你携带多少石头，都永远无法被填到那里。而当你的石头中途用完时，那些未能到达的地面会停留在锄头放置的位置，这将在下文进一步说明。

两者都不会被沉默地忽略，因为沉默正是这一切的开端：面板上的一个高度，以及地面在它下方戛然而止，却没有任何说明缘由。地面在下方太远，会在你挥动之前就让面板顶行变红， 超过原地面8米，而挥杆将 下方太远，无法升起 在屏幕中央。石头耗尽的提示有独立的面板行和消息，见下方。

价格就是锄头本身的代价。Jafna在锄头上找到抬地选项，取它的花费，再算出一次抬地挥动能在平地上增加多少地面。填充按每立方米以该比率消耗石头。这两个数值都来自运行中的游戏，并且每局只记录一次到日志里，所以如果其他模组改变了抬地的花费，填充也会随之改变。

你可以在哪里做这件事也是如此。用石头抬升需要附近有工作台，因为抬升地面就是这样：它的条目里写明了工作台，而游戏不会让你在离工作台超出其建造范围的地方挥动它，无扩展的工作台范围是20米，从你站的位置算起。填平会从同一个条目读取工作站，并遵循同样的规则。超出范围时，本需要用石头的一次挥动就只属于锄头：地面会升起它免费的那一米，以锄头的方式缓和处理，且不会消耗石头。面板的顶行显示 装填需要附近有工作台 而它的工作台那一行显示附近没有，而摆动将 提升需要附近有工作台 在屏幕中央。带有NoWorkbench设置的世界会解除这一规则，nocost命令也是如此，两者对抬高地面都有效。NoBuildCost则不行：在那里抬高地面是免费的，但仍然需要工作台。

在斜坡上，抬升地面用同样的石料填得更少，所以直接填比手动整平更省。交替手动抬升地面和整平仍然能胜过它。每次抬升地面都会让下一次整平挥动白赚一米，而填充不会。如果填充也能白赚，那每次挥动都能白赚一米，整平就相当于无代价地抬升地面了。

只有锄头永远做不到的那部分才计费。每个点都会免费获得锄头本应给予的米数，扣除先前挥动已经用掉的部分，剩下的路程才需要付费。一个点超出其免费米数不到三厘米时，不会被抬升到超出该范围，也不花费任何东西，所以在已经平整的地面上作业不会消耗石料。石料从你的背包中整块取出。当一次挥动需要用到一块石料的一部分时，会取出一整块，剩余部分保留用于你的下一次挥动，直到你退出登录。如果你挥动所涉及的条目本身需要消耗石料，填充会为你保留相应数量的石料在背包中。

当你资源不够时，挥动会先把石料用在你瞄准的圆圈中心，再向外扩展，把每个点都抬到你的高度，直到石料耗尽。更靠外的地面只会获得锄头自身的缓动效果，不消耗任何资源，屏幕中央则会提示你已经用完了。所以一次资源不足的挥动会留下中间一块平坦区域，周围有一圈台阶。中间优先，因为那是你瞄准的地方，而从它向外扩展的区域会留下一条干净的边缘，方便你接着继续。第一个版本则是把石料均匀铺开，结果每个点都只按所需量提升相同比例，连中间都没能达到你的高度。

建造面板会在你挥杆前显示这次挥杆的消耗，而这就是挥杆实际会消耗的量。当你携带足够时，它就是整圈的代价。当你不够时，石头那一行会以红色显示你携带的数量以及全部消耗会是多少，而最上面一行会显示 石头短缺，只填中间当你连中间都付不起时，顶行显示 石头不足，无法填充任何部分，而且那一挥毫不费力。

设置了无建造消耗的世界可以免费抬升地面。nocost命令解除了限制，但仍会消耗你携带的石头，原版的抬升地面也是如此。

自动升起 在配置中关闭此项，即可恢复一米的高度上限。在服务器上，由主机决定。

为你自己关闭这块石头

自动抬起 是房主的规则和文件编辑。对玩家而言，则有他们自己的开关， 石料填充，在游戏中翻转，使用 J (石料填充键）在整平工具取出时。关闭时，你的每一次挥动都只属于锄头：它的免费计量，不取石，不抬过它，面板也不再报价。面板的最后一行，在成本下方，说明了是哪一种， 石料填充：开，J 键关闭，所以没有采到石头的挥动从来不会让人意外。当锄头收起、聊天或控制台占用键盘时，该键不起作用，它会在屏幕左上角告诉你它做了什么。

主持人的 自动升起 仍是上限。关闭意味着对所有人关闭，开关无法将其重新打开，面板上写着： 石头填充：关闭，此服务器已关闭该功能。在那里意味着每位玩家仍然可以自行关闭它，而且这个开关只属于你：它永远不会被服务器接管，其他玩家的开关对你没有任何影响。它保存在cfg中，因此下次会话时保持不变。而保持的高度则不同，因为保持的高度是你出于某个可能忘记的原因而设定的数值，而这是一个面板每次都会显示的偏好设置。

J在本游戏自身的按键绑定以及其他模组中都没有被分配任何功能。它不是左Alt键，那是Jafna的 按住，而不是左Shift键，那是原版的替代放置方式。

触及，以及为何值得

这是将斯卡夫特的规则应用于第二种工具：制作购买的是触及距离，而非折扣。曲线相同，来自同一个共享源文件，因此“60点下8米”在两个模组中不可能意味着两种不同的东西。

触及范围特意做成这个模组中较小的一半。更宽的挥击确实有用，因为一次挥击只有一个参考高度，所以单次挥击覆盖的区域天然就是平的。但它本身并不能解决任何问题。一旦某个区域需要两次挥击，你就又回到了两个高度，而一对6米挥击之间的接缝，修复起来远比两个原版挥击之间的接缝糟糕得多。继续延展平面，才让大范围挥击成为好主意而非危险之举，所以它在所有技能等级都开启，而触及范围则不然。

使用的触及范围始终取曲线与工具自身半径中的较大值，因此 最小半径 可以在零处保持不变，意味着“新角色一开始得到的锄头就是游戏初始自带的”。调参时这一点值得注意：锄头自身的半径是3米，所以在默认曲线下，在制作等级大约25之前完全不会发生变化，而 最大半径 6个中的是原版顶部半径的两倍。

守卫

原版在你升级时只检测一个点：准星下方的那个点，而不检测工具实际覆盖的范围。所以即便是原版的锄头，也能在你站在别人栅栏外时，把邻居墙脚下的地面挖掉，而预览框还显示蓝色，领地保护也从不闪烁提示。这在原版范围下只是个小漏洞，但一旦合成升级把工具范围变大，漏洞就会变得很大，因此 Jafna 会检测整个作用范围，只要有任何一部分落在你无权进入的领地内，就拒绝这次挥动。锄头的操作范围是圆形的，所以检测就是一个圆；如果是方形范围，则会按它的四个角向外扩展来检测。

要清楚这有什么价值。它是在你挥动的位置上生效，而不是在世界存档的位置上。Valheim 中的地形由拥有该区域的客户端应用，这条路径上没有任何服务端验证，所以这能拦住模组，也能拦住诚实玩家。它拦不住恶意玩家。原版本来就是如此，而这并没有让情况变得更糟。

安装中

需要BepInEx。没有其他要求。通过模组管理器只需一次安装。手动的话，把 贾夫纳.dll 在 BepInEx/plugins/Jafna/.

然后启动一次游戏再退出。首次运行会写入配置文件。在模组加载之前该文件并不存在，这也是人们通常误以为模组出问题的原因。

核心模组是可选的，且非强制。安装后，Jafna会加入版本校验，主机端的范围、守护和复活设置将成为所有玩家的统一规则。不安装的话，模组对你的效果完全一样，只是守护规则会变成玩家之间的约定，而非服务器的强制属性。

设置

每项设置都在 BepInEx/配置/ezomic.valheim.jafna.cfg，而每个都将其推理保存在文件中而非此处，因此只需维护一个地方。值得了解的规则有：

• 继续 彻底关闭这个想法，让你回归原版升级体验。
• 最大半径 这是制作等级达到60时挥动所能达到的半径。默认值为6米，而锄头本身只有3米。
• 继续容差 是附近成形地面之间可以相距多远，超过这个距离模组就不再信任它。平滑后的地块是一个浅碟形而不是平台，所以这个值比看起来要宽松。
• 尊重守护足迹 以上是病房规则。
• 自动抬升 正在为石头垫高低地。默认开启。
• 石料填充 是你自己的开关，而且 石料填充键 在游戏中翻转它。这是个人设置，所以服务器永远不会设置其中任何一个。
• 显示读数 是建造面板的线条。

BepInEx 会在首次运行时将每个条目写入磁盘，而已保存的值会优先于代码中后来的默认值，因此如果某个设置看起来毫无作用，请先检查 cfg 文件。

多人游戏

地形由拥有该区域的客户端应用，通常并非挥砍的玩家。

持续平坦读取的标志已经在那台客户端的机器上。作用范围则不在，而原版的地形消息没有空间容纳它，因此Jafna将数字附加在一个无人读取的位置。运行Jafna的拥有者会发现并使用它；没有Jafna的拥有者永远不会查看，并执行完全普通的原版操作。两个方向都不会出问题，没有该模组的玩家也永远不会被服务器拒之门外。

那个附加的标记也是主人判断该操作是否属于一次锄地挥动的依据。当地形操作到达主人端时，一次锄头挥动看起来与地形自行改变、其他模组的操作或开发工具包的地面压平完全相同。因此，你的客户端会为你进行的每一次挥动添加该标记，宽度也与锄头自身宽度一致，并且只添加在挥动上，而主人端只会重塑携带该标记的操作。其他一切都会按原版处理，等同于不含 Jafna 的玩家进行的挥动。1.0.0 版本的客户端只会为宽于锄头自身宽度或瞄准已持有高度的挥动添加该标记，因此该版本的主人端不再会在该客户端的其他挥动下继续压平。

为石头垫高地面时，分界方式相同。你的客户端会计算出这次挥动是否需要石头，以及你的背包从挥动中心向外多远处开始付费，并把这段距离连同触及范围一起发送出去。区域所有者会把该范围内所有低点抬升到你的高度，告知你的客户端它抬升了什么，然后你的客户端扣除石头。用的是距离而非石头数量，这样一次跨越区域边界的挥动会在边界两侧停在同一个位置，而每个区域的所有者都采信你的客户端关于这次挥动需要石头的说法，而不是根据自己这半边自行判断，因此一次付费的挥动只有一个平坦的顶部，而不是平坦的半边挨着缓升的半边。事后付费是刻意设计的：没有这个版本的所有者什么也不会抬升，也不会发来账单，所以你没有为从未移动过的地面付任何费用。

你是否在工作台附近也是由你的客户端来判定的，因为只有你的客户端才知道你所在的位置。当你不在工作台附近时，你的客户端根本不会发送距离信息，因此也就不会要求所有者为此挥动提高任何东西，也不会有账单返回。

当区域属于他人时，一旦对方的机器响应，你背包里的挥击石就会扣除。因此，两次快速挥击可能扣掉比你持有量更多的石头。差额会记为欠账，并在你下次补充时从你携带的石头中扣除。

你对那块地的整治也可以是一次补挥。第二挥若来得太快，可能看到的仍是第一挥已经抬升过的地面，于是它抬升的地块就少于你这块石头所付的代价，还会说你石头不够，其实你还有石头。它也可能在主人的地已经近得只需锄头就够时，仍替一次已付钱的挥动作出挥击；这时主人只抬起它发现仍然低的部分，并且只按那部分计费。无论哪种情况，你都只为真正被抬升的地付钱，而下一挥就能把那块地整治完。

锄头到底有什么用

读取2026年9月20日的进行中游戏，因为它完全不在磁盘上。锄头的平整地面条目是 泥路_v2，它是个 平滑 行动，不是一级： 平滑 真， 关卡等级 假，半径3米，威力1，在同样的3米范围内涂抹泥土。抬高地面是 提升_v2 而Path仅用于绘制。锄头表中没有任何内容使用 等级.

这关系到这个模组能承诺什么。 平滑地形 将每个点缓慢移向目标，幅度为 1 - (距离/半径)^威力 并把自身累计的位移限制为每点一米，只有升级或抬升操作才会将其存入永久高度并重新释放预算。因此，用锄头平整在设计上就是渐近的，并且每点上限接近一米。Jafna在每次挥动时都不去动那个缓动，即使上限本来会提前截停。它改变的是所有这些挥动正在缓动趋近的高度，所以它们会汇聚到一个结果，而不是跟着你的准星走。向上时，一次挥动若覆盖的地面上限本来会提前截停，对石头而言就算完成了：高度以下圆周的每一点都会升起其剩余自由米数的一部分，按原版计算的位置计算，剩下的部分则进入与抬升地面写入的同一个永久高度。所以一次挥动绝不会因为被填充而获得新的自由米数。

锄头的部件表未指定任何技能。 使用它不会提升任何东西，并且 玩家.获取建造耐力 它跳过了折扣分支，因此与锤子不同，第一个奖励背后没有隐藏的第二个奖励——到达范围是制作唯一能买到的东西。这也意味着这个范围不是自我获得的：你无法通过升级来获得更宽的锄头，这项技能来自在制作台制作和升级。这与Skaft的形状相同，在那里修理建筑也不训练任何东西。

未经检验之物

没有第二玩家参与运行过：两台机器之间往返的触及范围和账单传输，以及机主在未使用 Jafna 的情况下从某位玩家那里留下的摆动幅度，均为原版状态。守护印记在测试中也从未拒绝过任何东西，因为根本就没有守护印记可供其拒绝。

2026年9月29日，在单人模式中跑完了为采石而抬高低地的场景。这涵盖了付费挥镐的整个范围落在带边缘台阶的高地上、所采的石料以及每点免费米数从账单中扣除、石料不足时先抬升中间部分，还有工作台规则及其两条提示信息。尚未验证：挥镐前面板显示的价格、超出八米限制的地面被保留并已说明，以及剩余石料结转到下一次挥镐。

石制开关已构建并编译，但尚未在游戏中运行。其场景（贾夫纳石开关.txt) 尚未运行，也没有任何东西按下该键。

当天手动检查了忽略Alt+Tab的按住键。但与之同时按下会破坏轻击的组合键则没有检查。

同一场景会检查另一个高度层平台上旁边的开发套件是否压平至自身高度，并通过了测试。没有任何检查会检测持有的高度或制作触及范围是否避开了非挥动操作。

Bug 与建议

两人都去现场。 长屋.thijssensoftware.nl/漏洞 用于任何损坏的东西，以及 蒂延斯软件长屋/创意 是模组下一步该做什么。你也可以在那里给其他人的想法投票。

登录需要一个Steam或Discord账号。我根据这个列表来工作，所以投票决定我接下来选什么。