村民轮换

村民交易刷新

一款适用于 Minecraft Fabric 的便捷优化模组，为村民交易界面添加一个按钮，让你在进行任何购买前可以刷新他们的交易。

功能特性

• 刷新交易按钮：村民交易界面上方可自定义的按钮
• 可拖拽按钮位置：通过拖拽界面重新定位按钮
• 实时更新：无需关闭界面即可即时刷新交易选项
• 按键绑定支持：支持键盘和鼠标按键绑定所有模组功能
• 可配置刷新次数限制：设置每个村民交易可被刷新的次数上限
• 流浪商人支持：可选功能（在服务器上需管理员权限）
• 智能验证：仅对有效村民生效（必须拥有职业且未被交易过）
• 服务端安全：所有验证均在服务端进行
• 反作弊保护：清除交易输入槽位以防止物品复制

安装方法

1. 从 发布页面 下载
2. 将 .jar 文件放入你的 .minecraft/mods 文件夹
3. 必需：Fabric API（版本需与你的 MC 版本匹配）
4. 推荐：Cloth Config 20.0.149+（增强配置界面，不适用于 MC 26.x）
5. 推荐：ModMenu 16.0.0+（游戏内配置访问）
6. 使用 Fabric Loader 0.18.4+ 启动 Minecraft

使用方法

1. 打开村民的交易界面
2. 点击“刷新交易”按钮（或使用按键绑定）
3. 村民的 1 级交易将以新的报价重新生成

配置说明

配置文件位置

• Windows：%appdata%\.minecraft\config\villagercycle.json
• macOS：~/Library/Application Support/minecraft/config/villagercycle.json
• Linux：~/.minecraft/config/villagercycle.json

配置项

{
  "enableCycleButton": true,
  "allowWanderingTraders": false,
  "showSuccessMessage": true,
  "showWanderingTraderSuccessMessage": true,
  "villagerCycleLimit": -1,
  "wanderingTraderCycleLimit": 1,
  "buttonOffsetX": 6,
  "buttonOffsetY": -25,
  "buttonWidth": 100,
  "buttonHeight": 20
}

配置项	默认值	描述
enableCycleButton	true	显示/隐藏刷新按钮
showSuccessMessage	true	显示村民刷新成功消息（客户端侧）
showWanderingTraderSuccessMessage	true	显示流浪商人刷新成功消息（客户端侧）
allowWanderingTraders	false	启用流浪商人刷新（在服务器上仅限管理员）
villagerCycleLimit	-1	每个村民最大刷新次数：-1=无限制，0=禁用，1+=有限制（在服务器上仅限管理员）
wanderingTraderCycleLimit	1	每个流浪商人最大刷新次数：-1=无限制，0=禁用，1+=有限制（在服务器上仅限管理员）
buttonOffsetX/Y	6/-25	按钮相对于界面的位置偏移
buttonWidth/Height	100/20	按钮尺寸（像素）

按键绑定

所有按键绑定默认未设置。请在 选项 → 控制 → 村民交易刷新 中进行设置。

支持键盘按键和鼠标按键（如鼠标侧键 4/5）。

按键绑定	功能
切换按钮可见性	显示/隐藏刷新按钮
打开按钮位置界面	打开拖拽界面以重新定位按钮
打开配置界面	打开模组配置界面
重新加载配置文件	从磁盘重新加载配置
刷新交易	在商人界面中刷新交易（键盘或鼠标）

单人游戏 vs 多人游戏

• 单人游戏：所有功能可用，完全控制所有设置。
• 多人游戏：需要管理员权限（4 级）才能使用：
  • 允许流浪商人开关
  • 村民刷新次数限制
  • 流浪商人刷新次数限制

成功消息开关为客户端侧设置——每位玩家控制自己的偏好。

局限性

• 仅对尚未交易过的村民生效
• 仅对具有有效职业的村民生效（傻子/失业村民无效）
• 仅刷新 1 级交易（经验等级 0）
• 刷新时交易槽位中的物品将返还至物品栏

技术要求

• Minecraft：1.21.9、1.21.10、1.21.11、26.1 或 26.2
• Fabric Loader：0.18.4+
• Java：21+（MC 26.x 需要 Java 25+）
• Fabric API：必需（版本需与你的 MC 版本匹配）
• Cloth Config：可选，推荐（不适用于 MC 26.x）
• ModMenu：可选，推荐

许可证

MIT 许可证 — 可自由包含在整合包中。

支持

如有 Bug 或建议，请在 GitHub 上提交 Issue。

作者

由 Partacus-SPQR 创建