瓦尔海姆的友好伐木巨魔。放置营地，设定工作范围，分配箱子——它们会砍树、砸原木、收集木材并储存。可选重新种植。支持多人游戏。

英灵神殿伐木NPC

让你的伐木全自动运行。 放置一处家园，设定工作范围，分配几个箱子——然后让一位友好的 木材巨魔 砍树、砸原木和树桩、捡木材并储存起来，这样你就能腾出手来劫掠、建造和探索了。

精彩集锦

• 免手动记录 —砍伐树木，劈碎倒下的原木和树桩，收集掉落物，并存放木材。
• 你来决定搭配 —为每种树木设置砍伐优先级和补种优先级，并筛选至家园生物群系。
• 可选补种 — 清除树桩后，可以用背包中的种子种植树苗。
• 仓储处理 — 分配普通瓦尔海姆箱子；存放多余物品，箱子满时暂停。
• 多人游戏安全 — 适用于本地世界、玩家主机游戏和专用服务器。
• 简单的游戏内菜单 — 一切都由家园面板上的一个控制板驱动。

版本	1.0.1
作者	皮扬基
授权	麻省理工学院
需要	BepInExPack 英灵神殿 + 霜巨人
安装到	专用服务器 和 所有客户端（相同版本）

---

安装

使用 r2modman / Thunderstore 模组管理器（推荐）

1. 安装 BepInExPack 英灵神殿 和 霜巨人.
2. 安装 英灵神殿伐木NPC (Pjanky-瓦尔海姆伐木NPC）。
3. 请在专用服务器和每个客户端上使用相同的模组。

手动

1. 为Valheim和Jötunn安装BepInEx。
2. 复制 瓦尔海姆伐木NPC.dll 进入 BepInEx/plugins/ValheimLumberNPC/ 在服务器上 和 每个客户。
3. 先启动一次，配置文件会生成在 BepInEx/配置/.

该模组添加了一个锤子建筑部件： 伐木家园.

默认仅服务器 管理员 可以放置家园并打开面板。要让任何玩家管理伐木场，请设置 仅限管理员放置 和 仅限管理员访问 至 假 （见 配置。

---

快速开始

一切都源自于 木屋农庄 面板——与已放置的家园互动以打开它。

1. 放置家园 你希望进行伐木的位置。它会自动生成你的第一个伐木巨魔。
2. 设置工作范围 在主页上（默认 40米，可调节 10–100米）。
3. 添加存储空间。 把宝箱放在附近并点击 添加宝箱 每个。
4. 调整天赋树优先级 下 木材设置 如果你愿意（按生物群系筛选）。

就是这样——只要玩家保持该区域处于加载状态，巨魔就会砍伐、砸碎原木/树桩、收集木材并存入你的箱子中。当箱子装满后，工作会暂停，直到你腾出空间或添加另一个箱子，然后才会继续。

你离开时巨魔消失是正常现象。 他们是临时工，不是永久生物。你的家园设置、范围和箱子分配都已保存。回来时，打开面板并点击 添加巨魔 如果没有任何存在。

---

工作原理

• 这 家园 区块在世界存档中存储持久数据（箱子、暂停状态、工作范围、树木优先级）。
• 木材巨魔 只在玩家保持该区域加载时才会工作——它们是被召唤的工人，不是四处游荡的怪物。
• 工作循环： 找树 → 砍伐 → 砸碎原木 → 砸碎树桩 → （可选重新种植） → 收集木材 → 存入.
• 在多人游戏中，AI运行在拥有该NPC网络视图的节点上，这样既能保证专用服务器的安全，又不必让无头服务器模拟每一个巨魔。
• 与巨魔对话可切换 暂停/继续 为了那个家园。

---

完整设置指南

1. 放置伐木工宅基地

打开锤子，选择 伐木家园，并将其放置在你想清理的树木附近（朝向无所谓）。与其互动以打开面板。状态栏会显示暂停状态、巨魔数量、工作半径和宝箱数量。

2. 设置工作半径

在主页下方 工作区，拖动 工作半径 滑块（10–100 米）。此圆圈外的树木将被忽略。

提示： 最大工作半径 在BepInEx配置中有一个 服务器上限，而不是当前家园的半径。请在UI中更改半径。如果配置上限卡在40，那么在该配置提高之前，滑块无法调高（较新版本会自动将40的上限修正为100）。

3. 分配宝箱（储存）

1. 将普通瓦尔海姆箱子（或兼容容器）放置在宅基地附近。
2. 点击 添加宝箱 为分配最近空闲的宝箱，范围在 宝箱分配范围 默认 20米）。重复操作以增加存储空间。
3. 清理宝箱 取消分配所有宝箱（其内容永远不会被删除）。
4. 宝箱物品栏 显示所有已分配宝箱的合并内容。

4. 配置木材设置

打开 木材设置仅出现与家园生物群系（显示于右上角）匹配的树木类型。

• 树木优先级（左） — 砍伐时选择该树木类型的相对概率。数值越高越优先。设置为 0 跳过砍伐该类型。
• 重植优先级（右） — 清理树桩后，从袋子中种植树苗时优先选择哪类种子。设置为 0 永远不要再种那种植物。补种只会使用巨魔袋子里已有的种子（不会从箱子里取种子）。

点击 返回 完成后。

哪些树出现在哪里

生物群系	已显示的树木类型
草地，海洋	山毛榉，桦树
黑森林	山毛榉、桦树、冷杉、松树、橡树
沼泽	沼泽（远古）
平原	桦木、橡木
山脉，极北之地	冷杉
迷雾之地	伊格
灰烬之地	白蜡木

家园的位置决定生物群系。并非每个家庭都有可种植的树苗——只有在存在种子和树苗的地方才需要补种（例如山毛榉/桦树/冷杉/松树/橡树）。

5. 添加巨魔并开始

1. 待在宅基地附近，让该区域保持加载（放置宅基地时已经生成了一个巨魔）。
2. 使用 添加巨魔 以获取更多工人，或找回在你离开后消失的工人。
3. 确保状态为 工作中 （使用 切换暂停 如果需要的话）。
4. 移除巨魔 使一名工人消失； 全部存入 空桶把木头搬进箱子。全球上限为 最大伐木工数量 默认 8。

---

家园面板

主菜单

一切操作的中心：暂停/继续、管理巨魔、分配存放、设定范围，以及打开伐木设置。

控制	它的作用
切换暂停	暂停或恢复此家园的日志记录
添加巨魔	再生成一个伐木工，或找回一个消失的伐木工
移除巨魔	从这个家园移除一个巨魔
全部存入	将携带的物品推入指定箱子
巨魔库存	查看附近巨魔携带的物品
添加宝箱	分配范围内最近的空闲宝箱
开启宝箱	取消分配所有宝箱（保留内容）
宝箱物品栏	浏览合并后的宝箱内容
工作半径	切碎／搜索半径滑块（10–100 米）
木材设置	树木砍伐优先级和补种优先级

巨魔库存与宝箱库存

快速查看你的巨魔持有物品以及指定宝箱中的物品——每项都带有实时物品列表、物品总数页脚，以及一个 刷新 按钮。

巨魔库存	宝箱库存

---

配置

首次启动后，请编辑 BepInEx/config/com.pjanky.valheimlumbernpc.cfg在专用服务器上，这些值为 服务器权威；更改它们后重新连接。

每座农舍的工作半径和树木优先级为 不 在这个文件中——它们存在于每个家园上，并可在UI中进行编辑。

通用

设置	默认	描述
仅限管理员放置	真	只有管理员才能放置或移除伐木工小屋。
仅管理员可访问	真实	只有管理员才能打开面板并更改设置。设置 假 开放获取。
伐木工上限	8	全世界/服务器范围内活跃伐木NPC的硬性上限。

日志

设置	默认	描述
最大工作半径	100	服务器硬上限 按(m)查看工作半径——并非宅基地当前半径。在界面中设置半径（10–此数值）。
默认布局模式	加权	新家园的默认优先级模式（加权）。
扫描间隔	2	伐木工工作时，后台树木/工作区刷新间隔秒数。
宝箱分配范围	20	使用时的与家园最大距离（米） 添加宝箱.

背包

设置	默认	描述
物品栏容量	20	最大 不同的物品堆叠 巨魔可携带（非物品总数）。

网络

设置	默认	描述
预约超时	30	树木预留的持续秒数，超时后其他伐木工可以砍伐。

AI

设置	默认	描述
启用木材音效	真	巨魔语音。设定 假 让伐木工静音。
思考间隔	0.5	AI决策间隔秒数。越低越灵敏，占用CPU越高。
移动速度	2.5	任务间的移动速度。
工作范围	3	距离（米），用于砍伐、拾取木材或使用箱子。

调试 / 界面

设置	默认	描述
调试日志	假	详细的 AI 日志。正常游玩时请关闭。
记录反馈到聊天	真	同时将宅基地反馈写入聊天。屏幕中央消息始终显示。

---

多人游戏说明

• 安装 相同模组版本 在服务器和所有客户端上。
• 家园数据通过该地块保存在世界中。
• 多个巨魔可以共用一个家园；它们会协调分工，这样就不会有两个巨魔争抢同一棵树。
• 巨魔只有在有人保持该区域加载时才会工作。
• 当分配的箱子无法再容纳更多木材时，家园 暂停 并宣布宝箱已满。

---

故障排除

问题	试试这些
无法放置家园	你不是管理员，并且 仅管理员可放置 是 真.
无法打开面板	仅管理员可访问 是 真 而你不是管理员。
半径卡在40米	检查配置 最大工作半径 ——这是上限。提高它（或更新到自动修正40上限的版本）。
巨魔待机	已暂停；范围内没有树木；优先级均为0；背包已满且箱子已满；或区域未加载。
巨魔消失了	你离开后就正常了—— 添加巨魔 再次在附近时。
宝箱未分配	将宝箱移动到 宝箱分配范围 并点击 添加宝箱 再来一次。
宝箱已满 暂停	在指定的箱子中腾出空间或添加另一个箱子，然后 切换暂停 / 取消暂停。
禁止补种	把种子装进巨魔袋；将重新种植优先级设为大于0；必须先砸碎树桩。

---

开发

仓库： github.com/nico8034/LumberNPC

# 本地调试构建 → r2modman 默认配置文件插件 powershell -ExecutionPolicy Bypass -File ValheimLumberNPC/scripts/deploy-local.ps1 # Thunderstore 压缩包 → ValheimLumberNPC/dist/ # （先提升 Plugin.PluginVersion；更新 Package/CHANGELOG.md） powershell -ExecutionPolicy Bypass -File ValheimLumberNPC/scripts/package-thunderstore.ps1

同时复制 环境.道具.示例 → 环境.道具 并设置 瓦尔海姆安装 为IDE/Jötunn构建后部署。版本唯一可信来源： 插件版本 在 Plugin.cs (语义化版本控制)。

---

许可证

在以下许可下授权 MIT 许可证《英灵神殿》版权归 Iron Gate AB 所有——本模组需要游戏的合法副本。