村民自动交易

这是一个 Fabric 模组，让村民利用放置在它们周围的箱子或木桶中的物品自动执行交易。

在村民上方放置一个输入箱子，在下方放置一个输出箱子，通过简单的 GUI 配置你希望启用的交易，然后让村民在工作台工作时处理其余的事情。

特性

• 免手动交易 —— 只要输入箱子中有购买物品且输出箱子有空间，村民就会自动执行其交易选项
• 每个村民独立配置 —— 按住 Shift 并右键点击任意村民以打开配置界面
• 优先级排序 —— 上下拖动交易，让高价值交易排在最前
• 单独开关交易 —— 只启用你想要的交易，忽略其余交易
• 自然补货 —— 使用 Minecraft 内置的交易限制（每个交易选项达到其 MaxUses 上限后停止，村民访问工作台时补货）
• 在村民工作时间内生效 —— 交易仅在村民值班时触发（游戏内白天，tick 2000–9000），遵循原版 AI

安装

要求：

• Minecraft 26.3、26.2 或 1.21.11 —— 在 Versions 标签页选择与你版本对应的文件。一旦 Fabric API 支持新的 Minecraft 版本，模组就会自动构建并测试。
• 对应版本的 Fabric Loader 和 Fabric API
• Minecraft 26.x 需要 Java 25（官方启动器会自带），1.21.11 需要 Java 21

将 villager-auto-trade-<version>.jar 与 Fabric API 一起放入你的 mods/ 文件夹。客户端和专用服务器均可使用 —— 多人游戏中，每位玩家都需要安装该模组（配置 GUI 是客户端的）。

使用方法

每个村民的布置

[箱子或木桶]   ← 在村民正上方（输入）
[村民]          ← 站在输出箱子上
[箱子或木桶]   ← 在村民正下方（输出）

村民本身站在输出箱子的顶部。在村民头顶上方一格放置输入箱子。使用栅栏格或类似结构防止村民走开。

配置交易

1. 将村民想要购买的物品（例如绿宝石、纸、煤炭）放入输入箱子
2. 按住 Shift 并右键点击村民以打开配置界面
3. 勾选你希望自动执行的交易
4. 使用 ↑ / ↓ 箭头设置优先级（列表顶部的优先执行）
5. 点击 Save

观察运行

在工作时间内，只要物品和输出空间充足，村民就会对每个启用的交易选项每秒执行一次交易。一旦某个交易选项达到最大使用次数（红色 MAXED 标记），模组会跳过它并继续处理下一个。村民通过在工作台工作来自动补货。

补货需要工作台在触及范围内： 原版只会为站在其认领的工作台约 1.7 格范围内的村民补货。将工作台放在村民所在格子的旁边，否则其交易选项会一直显示 MAXED。

如果村民没有任何动作，请检查服务器日志：当缺少某些条件时（没有交易、上方或下方没有箱子），模组会为每个村民写一行日志；问题解决后也会写一行日志。

配置界面

按住 Shift 并右键点击村民可打开该界面。它会显示：

• Auto Trade Enabled —— 该村民的全局开关
• 交易列表 —— 用于启用的复选框、用于调整优先级的 ↑↓ 按钮、缺货交易选项的 MAXED 指示
• Save / Cancel —— 保存会写入村民的 NBT 数据，在重启后仍然保留

兼容性

• 适用于所有村民职业（图书管理员、农民、武器匠等）以及任何类型的工作台
• 兼容箱子、陷阱箱、木桶以及任何实现了 Inventory 的方块实体
• 已知与常见的生活质量模组无冲突

许可证

MIT —— 可自由使用、修改或再分发。

致谢

由 Dziko3000 制作。