Custom Villager Modifications - 自定义村民经济管理

💡简介

Villager Modifications 是一款用于控制服务器附魔书经济的插件，它无需禁用村民交易，即可精确调控每项交易所使用的货币类型与数量。村民通常以极低价格（如30个绿宝石）提供本应更难获取的附魔书，此插件能有效解决此问题，维持服务器经济平衡。插件主要针对 1.15 版本开发，交易修改功能在 1.14 上有效，但由于 Mojang 漏洞 MC-157136，使用限制功能在 1.14 上无法生效。

---

🎮核心功能

• 全局交易控制：覆盖服务器上所有新生成村民的交易，无需设置特定村民。玩家在任何地方创建的村民都会自动应用限制。
• 自定义交易货币：为每项交易指定任意材料作为货币，并设置所需数量。
• 自定义附魔书兑换物：可将兑换附魔书所需的“书”物品替换为自定义物品，便于通过投票箱或商店控制其供应。
• 交易使用次数限制：控制每项交易在村民补货前可使用多少次。
• 交易时间限制：可设定特定附魔书交易仅在一天中的特定时段开放。
• 物品交易全面控制：通过配置，可对村民能提供的任何物品交易进行限制和编辑。
• 插件兼容白名单：可将特定村民排除在插件影响之外，确保与其他村民插件兼容。

---

🔧指令与权限

指令

• /vmbook：OP 可获取用于自定义附魔书交易的自定义“书”物品模板。
• /vmwhitelist：将当前所看村民加入白名单（需权限）。
• /vmremove：将当前所看村民从白名单中移除（需权限）。
• /vmoff：关闭当前所看村民的白名单状态。

权限

• VillagerModifications.whitelist：允许玩家使用白名单相关指令。

---

✨配置说明

自定义交易物品

• 在配置文件的 CustomItem 列表中，添加物品的 Bukkit 材质名（必须全大写）。材质列表可在此查询：Bukkit Material Javadoc。
• 参考配置文件中 CLOCK 的示例格式，为你添加的物品创建对应的限制配置块。
• 确保 CustomItem 列表中的名称与下方配置块的标题完全一致。

自定义货币

• 用于替换绿宝石的材料同样需使用 Bukkit 材质名，请查阅上述 Material 文档。

交易使用次数（`uses`）

• 此数值代表交易在村民补货前可被使用的次数。
• 若设置为 1，初始库存为 1，村民每天可通过正常机制补货 2 次。这意味着首次治愈或生成时，玩家最多可获得 3 本书，之后每天最多 2 本。
• 若设置为 0，将完全禁用该项附魔书交易，玩家只能通过正常附魔或结构战利品获取。

---

❓注意事项与兼容性

• 版本支持：核心交易修改功能支持 1.14+，但使用限制功能在 1.14 上因 Mojang 漏洞 MC-157136 而无效。
• 白名单存储：白名单数据存储在独立文件中，请勿手动编辑，应仅使用游戏内指令管理。
• 经济服务器适用：本插件非常适合搭配 Towny 等经济类插件，用于维持附魔书等可交易物品的价值。
• 问题与更新：如有问题或想获取更新信息，请加入 Discord 服务器：https://discord.gg/rBYrcYVYsP。

---

⭐高级版本

如需完全控制村民和流浪商人的所有交易（包括编辑、添加、删除及彻底重做交易系统），请查看此插件的付费高级版本：

https://www.spigotmc.org/resources/villager-overhaul-1-14-1-19-restrict-modify-remove-add.91819/

---

🔧开发者信息

• 插件代码已在 GitHub 开源，可供参考、学习村民机制或创建自定义版本。
• 如果您正在使用本插件，欢迎在评论区留下服务器名称与 IP，我们将会把您加入使用服务器列表。
• 如有任何疑问，请在插件页面评论区留言，我会尽量每日回复。