
设置自定义村民商人 ,让他们出售你指定的物品并设定价格。你可以设置拥有无限供应量的管理员商店,也可以设置从箱子中获取货源的玩家商店。
如果你愿意,它还可以阻止任何非商人村民与其他实体进行交易。
对于那些只是希望找到一种便捷方式来修改原版村民交易(作为使用复杂 Minecraft 命令的替代方案)的用户,该插件还提供了一个图形化的普通村民编辑器以及流浪商人的编辑功能。
基本功能
- 轻松创建交易你指定物品的村民商人。
- 管理员商店,拥有无限货源。
- 玩家商店,其货源来自一个箱子。
- 多种类型的玩家商店:售卖、收购、交易以及出售书籍。
- 支持多种生物类型作为你的商人代表,包括告示牌商店和Citizens (NPC) 商店。
- 普通村民和流浪商人的编辑器。
- 丰富的配置选项。
- 可翻译的消息。
- 开源(源代码托管于 GitHub)
支持的服务器版本
Shopkeepers 支持最新的 Bukkit / Spigot 版本。
请注意,此插件旨在与 CraftBukkit(或 Spigot)配合使用。Bukkit 缺乏使此插件正常工作所需的一些 API。这意味着其他服务器软件(如 Tekkit、Forge、Cauldron 等)无法与此插件兼容。
其他CraftBukkit 或 Spigot 衍生版/分支版本可能可以工作,但并未获得官方支持。因此,如果你在使用这些版本时遇到问题,请尝试先在最新且干净的 Spigot 服务器上复现问题。
入门指南
所有文档均可在 Wiki 页面中找到:
展示
管理员商店:
通过游戏内的库存菜单配置交易:

生成的交易菜单:

玩家商店(例如售卖物品):
向商店箱子中填入货源:

通过游戏内库存菜单配置交易:

生成的交易菜单:

视频教程
更多视频教程可在 Wiki 中找到:
由 Donnie 制作的教程,解释了不同商店类型的设置:
由 Fan Staaff 制作的教程,详细展示了不同商店类型的设置:
由 LastKing2X 制作的教程,展示了不同商店类型的设置:
由 Ajneb97 制作的西班牙语教程,还提及了占位符物品和各种配置选项:
统计数据
本插件使用 bStats 来收集匿名的插件使用统计数据。这有助于我确定有多少服务器正在使用该插件、最常与哪些 Minecraft 版本配合使用,以及各个功能的使用程度。
以下是当前跟踪的所有信息列表:
- 通用信息:使用该插件的服务器数量、这些服务器上的玩家数量、在线模式、Minecraft 版本、插件版本、核心数量、系统架构、操作系统、服务器所在国家/地区、Java 版本。
- Shopkeepers 特定信息:是否使用了特定的相关插件(Citizens、Towny、WorldGuard、Gringotts、其他 Vault 经济插件)、商店数量、是否使用了玩家商店、配置中是否启用了某些功能(例如 WorldGuard/Towny 兼容性、Citizens 商店、延迟保存、彩色名称、箱子保护、移除不活跃商店、税率、严格物品比较、购买日志记录、禁用其他村民等)、包含商店的世界数量。
- 所有信息均可在此公开查看:
如果您想禁用服务器上所有插件的 bStats,请编辑文件 plugins/bStats/config.yml,或者通过在 Shopkeepers 配置中将 'enable-metrics' 设置为 'false' 来仅针对 Shopkeepers 禁用它。
已知潜在问题
Shopkeepers 最新版本已知潜在问题列表可在 Wiki 中找到:本文档记录了 Minecraft/Spigot 版本之间的差异,以及与 Shopkeepers 相关的现有 Minecraft/Spigot 问题。
如果遇到任何问题,请检查此列表中是否已包含该问题,并可能提供处理方法的说明。
有问题或进一步疑问?
如果您有紧迫的问题或简单疑问,可以加入 Discord 服务器并向其他插件用户寻求帮助:
但是 提交工单是获得帮助或报告插件问题的最佳方式。
在提交工单之前:
- 检查您的问题是否已在以下地方得到解答:
- 请检查是否已有关于您遇到的问题的 其他反馈。
在提交问题之前:
- 尝试在使用以下环境时复现您的问题:
- 最新版本的 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 | Observant Minecraft Server | Ren B. |
| BadWolfMC | Michael M. | Alejandro A. |
| Michael B. | Anton J. |
想要提供帮助?
无论您是否是程序员,都有许多方式可以做出贡献!例如:
- 在 Github、Discord 或评论区帮助用户解决问题和疑问。
- 创建和更新翻译文件。
- 随着插件的更新,保持文档(Wiki)的最新状态。
- 编写或维护附加插件(请参阅 Github 上的开放问题)。
如果您有兴趣或有其他关于如何贡献的想法,欢迎通过私信联系我。
附加插件
有时,某些功能过于特定,不适合直接包含在 Shopkeepers 插件中,或者我还没有时间自行添加类似的功能。您可以在 Wiki 中找到扩展 Shopkeepers 插件功能的官方和第三方附加插件列表:
如果您也编写了想要加入列表的附加插件,请告诉我!

Set up custom villager shopkeepers that sell exactly what you want them to sell and for what price. You can set up admin shops, which have infinite supply, and you can also set up player shops, which pull supply from a chest.
It will also prevent any other trades with non-shopkeeper villagers, if you want it to.
For those who are simply looking for a convenient way to modify the trades of vanilla villagers (as an alternative to using complex Minecraft commands), the plugin also includes a graphical editor for regular villagers and wandering traders.
Basic Features
- Easily create villager shopkeepers that trade the items you want them to trade.
- Admins shops with infinite supplies.
- Player shops which pull supplies from a chest.
- Different types of player shops: selling, buying, trading, and selling books.
- Various supported mob types to represent your shopkeeper, sign shops, and Citizens (NPC) shops.
- Editor for regular villagers and wandering traders.
- Many configuration options.
- Translatable messages.
- Open source (Source code on GitHub)
Supported server versions
Shopkeepers supports the latest versions of Bukkit / Spigot.
Note that this plugin is created to work with CraftBukkit (or alternatively Spigot). Bukkit does not have an API for some of the things necessary to make this plugin work. This means that other server software (Tekkit, Forge, Cauldron, etc.) will not work with this plugin.
Other CraftBukkit or Spigot derivatives/forks might work, but are not officially supported. So if you run into issues while using those, try to reproduce your issue on a fresh and up-to-date Spigot server first.
Getting started
All documentation can be found in the wiki:
- Downloads and changelogs for all files
- Installation
- Translations
- Configuration
- Permissions
- Creating shops
- Commands
- Frequently Asked Questions
Showcase
Admin shops:
Configure the trades via the in-game inventory menu:

Resulting trading menu:

Player shops (ex. selling items):
Fill the shop chest with supplies:

Configure the trades via the in-game inventory menu:

Resulting trading menu:

Video Tutorials
More video tutorials can be found in the wiki:
Tutorial by Donnie, explaining the setup of the different shop types:
Tutorial by Fan Staaff showing the setup of the different shop types in detail:
Tutorial by LastKing2X,showing the setup of the different shop types:
Spanish tutorial by Ajneb97, also mentioning placeholder items and various config options:
Statistics
This plugin uses bStats to collect anonymous plugin usage statistics. This helps me to determine how many servers are using the plugin, which Minecraft versions it is used with the most, and to which degree the different features are used.
Here is a list of all currently tracked information:
- Common information: The number of servers using the plugin, the number of players on these servers, online mode, Minecraft version, plugin version, core count, system arch, operating system, server country, Java version.
- Shopkeepers specific information: Whether specific related plugins are used (Citizens, Towny, WorldGuard, Gringotts, other Vault economy plugins), number of shops, whether player shops are used, whether certain features are enabled in the config (ex. WorldGuard/Towny compatibility, Citizens shops, delayed saves, colored names, chest protection, removal of inactive shops, tax rate, strict item comparison, purchase logging, disabling of other villagers, ..), the number of worlds containing shops.
- All information can be publicly viewed here:
If you want to disable bStats for all plugins on your server, edit the file plugins/bStats/config.yml, or alternatively disable it only for Shopkeepers by setting 'enable-metrics' to 'false' inside the Shopkeepers config.
Known potential issues
A list of known potential issues of the latest version of Shopkeepers can be found in the wiki: This documents differences between Minecraft/Spigot versions, and existing Minecraft/Spigot issues related to Shopkeepers.
If you run into an issue, check if this list already contains and maybe offers information on how to handle it.
Have issues or further questions?
If you have a pressing issue or simple question, you can join the discord server and ask other plugin users for help:
But submitting a ticket is the best way to get help or report a problem with the plugin.
Before submitting a ticket:
- Check if your question is already answered in:
- The documentation (wiki).
- The FAQ.
- The Known Issues.
- Check if there is already another ticket for your issue.
Before reporting an issue:
- Try to reproduce your issue when using:
- The latest versions of Spigot and Shopkeepers.
- No other plugins.
- No kinds of other server or client mods.
When reporting an issue:
- Provide the versions you are using of Minecraft, Spigot and Shopkeepers.
- Provide a detailed description of your problem and add as much information as possible which could help reproducing the issue.
- If possible, include step-by-step instructions on how to reproduce the issue on a fresh Spigot server.
Donations
If you like this plugin, consider supporting its developers by making a donation:
- To blablubbabc (current maintainer: Dec 2013 - today)
- To nisovin (former author: Aug 2012 - Dec 2013)
A big "thank you" to everybody who is keeping the motivation up through donations!
| 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 | Observant Minecraft Server | Ren B. |
| BadWolfMC | Michael M. | Alejandro A. |
| Michael B. | Anton J. |
Want to help?
Whether you are a programmer or not, there are many ways in which you can contribute! For example:
- Help users with issues and questions on Github, Discord, or the comment section.
- Create and update translations.
- Keep the documentation (the wiki) up-to-date with plugin updates.
- Write or maintain add-on plugins (see the open Github issues).
If you are interested or have other ideas on how you can contribute, feel free to contact me via PM.
Add-On Plugins
Sometimes, a feature is either to specific to include directly into the Shopkeepers plugin, or I did not yet have the time to add something similar myself. You can find a list of both official and third-party add-on plugins that extend the functionality of the Shopkeepers plugin in the wiki:
If you have also written an add-on plugin that you want to add to the list, let me know!
下载 Shopkeepers
下载 Shopkeepers
下载 Shopkeepers
下载 Shopkeepers
下载 Shopkeepers
下载 Shopkeepers
下载 Shopkeepers
下载 Shopkeepers
下载 Shopkeepers
下载 Shopkeepers
适用于 MC 26.3、26.2、26.1.2、1.21.11、1.21.10、1.21.8、1.21.7、1.21.6、1.21.5 的 v2.28.1
此处仅列出主要更改。有关 API 更改、内部更改以及语言文件更改的详细信息,您可以在 Github 上查看完整的更新日志:
- 权限:
shopkeeper.*权限缺失了部分权限。shopkeeper.notify.tradesshopkeeper.setcurrencyshopkeeper.teleportshopkeeper.teleport.othersshopkeeper.settradedcommandshopkeeper.snapshotshopkeeper.edit-villagersshopkeeper.edit-wandering-tradersshopkeeper.createshopkeeper.hanging-sign
- 修复:v2.28.0 引入的玩家商店物品复制问题,原因是未能在交易尝试失败时正确重置交易状态。
- 还增加了一项安全措施,如果之前的交易未正确结束,则中止后续的交易尝试。
- 修复:v2.28.0 引入的玩家商店物品复制问题,当多个商店容器共享同一个库存时发生,例如双箱的两个箱子。
- 修复:拥有快照的商店老板的容器列表迁移失败,因为快照数据不包含商店老板所在的世界。
- 修复:容器列表迁移未移除遗留的容器数据(
chestx、chesty、chestz)。 - 修复:玩家商店中的货币物品复制问题,当店主编辑报价而另一名玩家正在交易时发生。
- 如果交易配方的价格不再与相应报价的价格匹配,则中止交易。
- 我们还在编辑交易报价后立即关闭任何打开的交易视图,这样进行交易就不会看到过时的交易内容。
- 修复:商店创建物品和命名物品的物品复制问题,原因是使用过的物品在一刻后被移除。
- 修复:雇佣非商店村民时,如果玩家手中的雇佣物品未能覆盖全部费用,则只扣除部分费用。
- 修复:如果被直接杀死(例如被其他插件),商店实体可能会掉落物品和经验值。例如,狐狸商店老板总是掉落其口中的物品。我们现在清除濒死商店实体的掉落物。
- 修复:当 shift-click 交易被中止时(例如由于商店容器存储空间不足),交易未更新(例如其缺货可视化效果)。
- 调试:添加调试命令
/shopkeeper testKill,通过将目标实体的生命值设为零来杀死该实体。与原版 kill 命令不同,此命令会绕过伤害事件,可用于测试商店实体的死亡行为。 - 假设:
- 移除关于我们的
SKUnmodifiableItemStack的不再相关的章节:实现方式已在 v2.22.0 中更改。 - 添加关于
Inventory#equals的章节。
- 移除关于我们的
已知潜在问题:请参阅 此处。
捐赠
如果您喜欢这个插件,请考虑进行 捐赠。
谢谢!
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
插件
一个高度兼容、功能完善且稳定的 TPA 模组
插件
在 Minecraft 中加入“最后一击”、“第二次机会”和“最后喘息”机制!从高处坠落时,你将拥有 0.5 HP 而不是直接死亡;当生命值较低时,增强你的能力。
插件
更快速的直线轨道矿车、链式连接列车、熔炉机车,以及原版红石信号!
插件
城镇现在可以要求建造具有特定功能的建筑
插件
一个功能丰富、完全动画化的箱子插件,适用于 Paper 1.21.x,支持 IA、Vault、PlaceholderAPI 和 Citizens
评论 0
登录后参与评分
还没有评论,来抢沙发吧