Shopkeepers - 自定义村民商店

💡简介

Shopkeepers 是一款功能强大的 Minecraft 插件，允许你创建自定义的村民商店管理员，精确设定其出售的物品和价格。你可以设置拥有无限库存的管理员商店，也可以设置从箱子获取库存的玩家商店。此外，如果你愿意，它还可以阻止与非商店管理员村民的任何其他交易。对于那些只想寻找一种便捷方式来修改原版村民交易（作为复杂 Minecraft 命令的替代方案）的玩家，本插件还包含一个用于编辑普通村民和流浪商人的图形化界面。

🎮核心功能

• 自定义商店管理员：轻松创建交易指定物品的村民商店管理员。
• 管理员商店：拥有无限的供应。
• 玩家商店：从连接的箱子中提取供应物品。
• 多种玩家商店类型：包括出售、收购、以物易物和出售成书。
• 多样化的商店形式：支持多种生物作为商店管理员、告示牌商店，以及 Citizens NPC 商店。
• 原版村民编辑器：用于编辑普通村民和流浪商人的交易。
• 高度可配置：提供丰富的配置选项。
• 多语言支持：消息可翻译。
• 开源：源代码托管于 GitHub。

🔧支持的服务器版本

• 支持最新版本的 Bukkit / Spigot。
• 本插件专为 CraftBukkit（或 Spigot）设计。由于 Bukkit API 缺少某些必要功能，因此其他服务器软件（如 Tekkit、Forge、Cauldron 等）将无法运行此插件。
• 其他基于 CraftBukkit 或 Spigot 的衍生/分支版本可能可以运行，但不受官方支持。如果使用这些版本遇到问题，请尝试在全新且最新的 Spigot 服务器上复现。

✨快速开始

所有文档均可在 **Wiki** 中找到

• 文件下载与更新日志
• 安装指南
• 语言翻译
• 配置文件说明
• 权限列表
• 创建商店教程
• 命令列表
• 常见问题解答
• 示例展示

管理员商店示例

• 通过游戏内库存菜单配置交易。
• 最终交易界面。

玩家商店示例（如出售物品）

• 在商店箱子中放入供应物品。
• 通过游戏内库存菜单配置交易。
• 最终交易界面。

视频教程

更多视频教程可在 Wiki 中找到

• Donnie 的教程：讲解不同商店类型的设置。
• Fan Staaff 的详细教程：深入展示不同商店类型的设置。
• LastKing2X 的波斯语教程：展示不同商店类型的设置。
• Ajneb97 的西班牙语教程：涵盖占位符物品和各种配置选项。

❓数据统计

本插件使用 bStats 收集匿名的插件使用统计数据。这有助于了解有多少服务器在使用本插件、最常使用的 Minecraft 版本以及不同功能的使用程度。

统计信息包括

• 通用信息：使用插件的服务器数量、在线玩家数、在线模式、Minecraft 版本、插件版本、CPU 核心数、系统架构、操作系统、服务器所在国家/地区、Java 版本。
• Shopkeepers 特定信息：是否使用相关插件（Citizens, Towny, WorldGuard, Gringotts, 其他 Vault 经济插件）、商店数量、是否使用玩家商店、配置中启用的特定功能（如 WorldGuard/Towny 兼容性、Citizens 商店、延迟保存、彩色名称、箱子保护、移除不活跃商店、税率、严格物品比较、购买记录、禁用其他村民等）、包含商店的世界数量。

所有信息可在此公开查看：https://bstats.org/plugin/bukkit/Shopkeepers/

禁用统计

• 若要禁用服务器上所有插件的 bStats，请编辑文件 plugins/bStats/config.yml。
• 或者，仅在 Shopkeepers 配置中将 enable-metrics 设置为 false，以仅禁用本插件的统计。

💡已知潜在问题

最新版 Shopkeepers 的已知潜在问题列表可在 Wiki 中找到。该文档记录了不同 Minecraft/Spigot 版本之间的差异，以及与 Shopkeepers 相关的现有 Minecraft/Spigot 问题。

如果遇到问题，请先检查此列表，看是否已包含相关信息及可能的处理方法。

🔧遇到问题或有疑问？

如果有紧急问题或简单疑问，可以加入 Discord 服务器向其他插件用户寻求帮助。

但提交工单是获得帮助或报告插件问题的最佳方式。

提交前请检查

• 你的问题是否已在以下部分得到解答：
• 文档（Wiki）
• 常见问题解答（FAQ）
• 已知问题（Known Issues）
• 是否已有其他工单报告了相同问题。

报告问题前请尝试

• 在以下环境中复现问题：
• 使用最新版本的 Spigot 和 Shopkeepers。
• 不安装任何其他插件。
• 不使用任何其他服务器或客户端模组。

报告问题时请提供

• 你使用的 Minecraft、Spigot 和 Shopkeepers 版本。
• 问题的详细描述，并尽可能提供有助于复现问题的信息。
• 如果可能，附上在全新 Spigot 服务器上复现问题的步骤说明。

⭐捐赠支持

如果你喜欢这个插件，请考虑通过捐赠来支持其开发者：

• 捐赠给 blablubbabc（当前维护者：2013年12月至今）
• 捐赠给 nisovin（前作者：2012年8月至2013年12月）

衷心感谢所有通过捐赠保持我们动力的朋友！

特别鸣谢

Minecraft-Servers-Listing.com、TRS Game Servers、terminalserver.us、Minewind、mercurialmusic、timitimitimi、FatherWh0 (merchantvillages.com)、lukeeexd (tws-mc.com)、PapaJuan、EmeraldHaze (Ninjalette)、Espen、kbtalkin、Dimo (Beyond Vanilla)、RefugiaCraft、Frilioth、Tabletopcheese / Ghostmuffin、Observant Minecraft Server、Ren B.、BadWolfMC、Michael M.、Alejandro A.

✨想要贡献力量？

无论你是否是程序员，都有很多方式可以做出贡献！例如：

• 在 GitHub、Discord 或评论区帮助用户解决问题和解答疑问。
• 创建和更新翻译。
• 随着插件更新，维护文档（Wiki）的时效性。
• 编写或维护扩展插件（参见 GitHub 上的开放议题）。

如果你有兴趣或有其他贡献想法，欢迎通过私信联系我。

🎮扩展插件

有时，某些功能因过于特定而无法直接集成到 Shopkeepers 插件中，或者我尚未有时间自行添加类似功能。你可以在 Wiki 中找到一系列官方和第三方的扩展插件列表，它们可以增强 Shopkeepers 插件的功能：https://github.com/Shopkeepers/Shopkeepers-Wiki/wiki/Add-On-Plugins

如果你也编写了希望添加到列表中的扩展插件，请告诉我！