为英灵神殿打造的自主哥布林农夫。放置家园，标记田地，指定箱子——农夫们会种植、收割并储存作物。多人游戏安全；服务器和客户端都需要安装此模组。

英灵神殿农夫NPC

让你的农场自动运转。 放置一处家园，圈定你的田地，分配几个箱子——然后让哥布林农夫种植、收获并储存你的作物，而你则可以继续劫掠、建造和探索。

亮点

• 离线耕作 ——农民会自动收割成熟作物并在空地上重新种植。
• 你来决定搭配 —设置每种作物的种植比例和种子储备，并筛选出适合你所在生物群系实际能生长的作物。
• 存储已处理 ——农民会从你的箱子里取走种子，并将收获物存回其中。
• 多人游戏安全 — 适用于本地世界、玩家主机游戏和专用服务器。
• 简单的游戏内菜单 ——所有内容都由家园地块上的一个面板驱动。

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

---

安装

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

1. 安装 BepInExPack 英灵神殿 和 霜巨人.
2. 安装 英灵神殿农夫NPC.
3. 在专用服务器和每个客户端上使用相同的模组。

手动

1. 为Valheim和Jötunn安装BepInEx。
2. 复制 瓦尔海姆农夫NPC.dll 进入 BepInEx/plugins/ValheimFarmerNPC/ 在服务器上 和 每个客户端。
3. 启动一次，以便配置文件创建于 BepInEx/配置/.

该模组添加了两个锤子建筑部件： 农夫家园 和 农场界桩.

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

---

快速开始

一切都由 农夫家园 面板—与已放置的家园互动以打开它。

1. 准备一块田地。 翻土并种下你想耕种的作物（树苗或成熟的作物都可以）。
2. 放置家园 在田地附近。它会自动生成你的第一个农夫。
3. 设定边界。 放置 两个农场边界桩 在场地对角，然后点击 分配界桩.
4. 扫描场地。 点击 扫描磁场 ——宅基地会记住边界内的每一种作物作为工作槽位。
5. 添加储物空间。 在附近放置箱子并点击 添加宝箱 每个。

就是这样——只要玩家保持该区域处于加载状态，农民就会收割、重新种植、补充种子，并将余粮存入。调整他们的种植内容，在 作物设置 随时都可以。

农民在你离开后消失是正常的。 他们是临时工，不是永久生物。你的家园、田地和箱子内容都已保存。回来时，打开面板并点击 添加农夫 如果没有，则不进行任何操作。

---

运作方式

• 那个 家园 piece 将所有持久性农场数据（作物槽位、箱子、暂停状态、作物设置）存储在 worldsave 中。
• 农夫 只在玩家保持农场区域加载时生效——他们是召唤来的工人，不是游荡的怪物。
• 在多人游戏中，游戏会让所有玩家的农场保持同步；专用服务器即使在多名玩家共用一个农场时，也能保持田地进度一致。
• 与农夫交谈可切换 暂停/继续 为了那个家园。

---

完整设置指南

1. 种植初始田地（必需）

耕种土地并 种植你希望农民耕作的每一块土地. 扫描区域 从边界内已有的作物中发现槽位——它确实如此 不 在裸露的耕地中创建种植槽。首次扫描后，农民会自行收割并重新种植这些已记录的种植槽。

2. 放置农夫家园

打开锤子，挑 农夫家园，并将其放置在农场附近（朝向无所谓）。与其互动即可打开面板。顶部的状态栏会显示暂停状态、农夫数量、作物槽位数量、箱子数量以及是否已设置边界。

3. 放置并分配界碑

1. 放置 两根农场界桩 在你农场所在矩形的对角位置——刚好在最外层地块之外，这样每一格土地都包含在框内。
2. 保持每个半角字符在 最大农场半径 默认 64米），否则扫描将失败。
3. 在面板上，点击 分配界碑状态随后应显示为 边界：已设置如果失败，请靠近一些，确认两个帖子都存在，然后重试。

4. 扫描场地

点击 扫描场。农庄会清点边界内的每一种作物，并将这些位置记为农田槽位； 作物 数量应大于零。

使用 清空场地 仅用于清空已记住的槽位列表（在布局大幅变动后便于重新扫描）。它不会摧毁世界中的植物——如果你仍希望该田地继续被耕作，请在之后重新扫描。

5. 分配储物箱（存放）

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

6. 配置裁剪设置

打开 裁剪设置只显示能在本宅基地生物群落（右上角所示）生长的作物，其他作物会自动跳过。蔬菜列在前面，随后是其种作物（胡萝卜种子, 萝卜种子, 洋葱种子）；如果作物数量超出显示范围，列表会滚动。

• 剩余负重 — 相对种植比例。权重越高，在填充空位时种植得越频繁。蔬菜及其种子作物各有各的权重，因此你可以独立地偏好种子（例如用于鸡饲料）或食物。将某种作物设置为 0 绝不种植它（已种植的仍可收获）。
• 储备（右） ——至少保留这么多 该行产出的内容：胡萝卜储备存放胡萝卜，“胡萝卜种子”储备存放胡萝卜种子，而大麦/亚麻/巨人菇/法师帽则存放作物本身。当库存低于储备量时，农民会优先补充储备。
• 始终可持续 ——即使把某种蔬菜的重量设为0，农民仍然会种植刚好足够的量来维持其种子作物的供应，所以以种子为核心的配置永远不会让自己断粮。

点击 返回 完成后。

哪些作物长在哪里

生物群系	可种植作物
草甸，黑森林，海洋	胡萝卜、芜菁、洋葱
沼泽	芜菁
平原	胡萝卜、芜菁、洋葱、大麦、亚麻
雾隐之地	尤弥尔泡菇，法师帽菇
山脉，深境北地，灰烬之地	无

宅基地的位置决定生物群系。对于横跨边界的田地，请将宅基地放在你想要耕种的那一侧。

7. 添加农民并开始

1. 待在宅基地附近，以保持该区域加载（放置宅基地时已经生成了一位农民）。
2. 使用 添加农夫 想要更多工人，或者找回你离开后消失的那个。
3. 确保状态为 工作中 （使用 切换暂停 如有需要）。
4. 移除农夫 使一个工人消失； 全部存入 空箱将货物搬入箱子。全球农民上限为 最大农民数 默认 16）。

---

家园面板

主菜单

一切事务的中心枢纽：暂停/继续、管理农夫、扫描田地、分配仓储，以及打开作物设置。

控制	功能说明
切换暂停	暂停或恢复此家园的耕种
添加农夫	再生成一个农夫，或找回消失的农夫
移除农夫	从这个家园移除一位农民
全部存入	将携带的物品推入指定的箱子
农场主库存	查看附近农民携带的物品
扫描场	发现/刷新边界内的作物槽位
清空字段	忘记已记住的槽位（之后重新扫描）
分配界桩	将附近的两个界桩绑定
添加宝箱	分配范围内最近的空闲宝箱
清空箱子	移除所有宝箱分配（内容保留）
宝箱物品栏	浏览合并后的宝箱内容
裁剪设置	重量、储备、生物群系筛选作物

农夫物品栏与箱子物品栏

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

农夫库存	宝箱库存

---

配置

首次启动后，编辑 BepInEx/配置/com.farmerjohn.valheimfarmernpc.cfg在专用服务器上，这些值为 服务器权威; 更改后重新连接。

每块农田的作物权重和储备为 不 在这个文件中——它们存在于每个家园上，并在其中进行编辑 作物设置.

通用

设置	默认	描述
仅限管理员放置	真	只有管理员可以放置或移除家园和边界部件。
仅管理员可访问	真	只有管理员才能打开面板并更改设置。设置 假 开放获取。
最大农夫数	16	全世界/服务器内活跃农夫的数量上限。

耕种

设置	默认	描述
最大农场半径	64	X或Z方向边界的最大半宽（米）。超过此范围的场无法扫描。
默认布局模式	加权	种植模式： 新 家园： 加权 使用裁剪设置比例； 已修复 重新种植每个槽位的原始作物。在界面中编辑权重会将该家园切换为加权模式。
扫描间隔	2	农民工作时后台字段刷新的间隔秒数。
宝箱分配范围	20	使用家园时最大距离（米） 添加宝箱.

物品栏

设置	默认	描述
物品栏容量	20	最大 独立物品堆叠 一个农民可以携带的数量（非物品总数）。

联网

设置	默认	描述
预订超时	30	收获/种植槽位在被其他农夫占用前保留的秒数。

人工智能

设置	默认	描述
启用农民音效	真	哥布林叫声。设置 假 让农民闭嘴。
思考间隔	0.5	AI决策间隔秒数。越低响应越快，但更耗CPU。
移动速度	2.5	任务间的行走速度。
工作范围	2	距离收获、种植或使用箱子（米）。

调试 / 界面

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

---

多人游戏说明

• 安装 相同模组版本 在服务器和所有客户端上。
• 家园数据通过该地块保存在世界中。
• 多个农民可以共用一个家园；他们会相互协调，以免两人争夺同一块土地。
• 农民只有在有人保持该区域加载时才会工作。

---

故障排除

问题	可以试试
无法放置家园/营地桩	你不是管理员，并且 仅管理员可放置 是 真.
无法打开面板	仅管理员可访问 是 真 而你不是管理员。
边界缺失/扫描失败	分配两个岗位；保持字段≤ 最大农场半径；帖子必须形成真正的矩形。
作物设置中没有作物	该生物群系没有可种植的作物（例如山地），或者你尚未进行扫描。
农民空闲	已暂停；没有成熟或空置的工作；袋子和箱子里没有种子；或者区域未加载。
农夫们消失了	你离开后就正常了—— 添加农夫 再次在附近时。
宝箱未分配	在内部移动箱子 宝箱分配范围 然后点击 添加宝箱 再来一次。

---

开发

仓库： github.com/nico8034/FarmerNPC

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

同时复制 环境.道具.示例 → 环境.道具 并设置 瓦尔海姆安装 用于 IDE/Jötunn 构建后部署。版本权威来源： 插件版本 在 插件.cs （语义化版本）。

---

授权

根据以下许可协议授权 MIT 许可证. Valheim 是 © Iron Gate AB 的版权作品 — 本模组需要游戏的合法副本。