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: https://github.com/Shopkeepers/Shopkeepers-Wiki/wiki/Video-Tutorials
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: https://bstats.org/plugin/bukkit/Shopkeepers/
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 Binden |
Want to help?
The less I have to do myself, the more time I have to write plugins. Therefore I am looking for someone who would be willing to get involved in the project. That could for example mean:
- Keeping the documentation (the wiki) up-to-date with plugin updates.
- Improving the existing documentation.
- Creating and maintaining translations.
- Help managing issues and answering questions of users.
If you are a programmer with experience in writing bukkit plugins, or have ideas on how you can contribute to the project beyond that, let me know as well! If you are interested, feel free to contact me via PM.
Beyond that, everybody is invited to help others with issues and questions in the issue tracker, comment section, and the discord channel! Also consider contributing translations!
Third-Party Add-On Plugins
Sometimes a feature is either to specific to include it directly into the Shopkeepers plugin, or I did not yet have the time to add something similar myself. The plugins listed here extend the functionality of the Shopkeepers plugin.
These plugins are maintained by other community members. If you run into issues while using any of these add-ons, try to first reproduce your problem without any add-ons before you report it.
ShopkeepersNavAddon(abandoned): Adds inventory-based GUIs that allow you to browse all player shops, all admin shops, and to find shops that trade a specific type of item. You can teleport to a particular shopkeeper by clicking a button inside the GUI.
This plugin also integrates support for trading with Vault-based currency, but does so by replacing Shopkeepers' normal trade handling.
If you have also written an add-on plugin and want it listed here, let me know!
Hey everyone :)
found it sry :'D
I Love this Plugin :)
Greetings
Hello. LOVE The plugin. I was curious if there's anyway you can officially support paper???
I think your plugin is currently causing my paper server to crash unfortunately, but I really don't want to stop using it.
In reply to hollowgroundxX:
It's up to the Paper devs to ensure that plugins working on Spigot also work on Paper.
Paper has some internal differences to Spigot which I am not as familar with. In order to not spent too much time with debugging issues, I ask people running into issues with Paper to first try to reproduce them on Spigot. So then I can focus on either the Spigot/minecraft server internals, OR the Paper patches possibly related to the issue, and don't have to consider both.
If you can reliably (with minimal and easy to follow reproduction steps) track down some issue with Shopkeepers and Paper, and you have confirmed that the issue does not occur on Spigot, create a ticket over at github and I will look into it.
In reply to hollowgroundxX:
It worked on Paper for me in 1.13
Hi there! Thanks for making the plugin!
I'd like to do a request, could you please incorporate villager rebalancing to the plugin? The plugin you linked in the FAQ is 4 years old, and doesn't work right now, so its really not an option :/
Thanks for considering it.
Have a nice day!
In reply to imtile:
This is out of scope for this plugin.
In the past there has also been this (https://www.spigotmc.org/resources/custom-village-trades.25792/), but this seems to be abandoned as well by now.
If someone finds an up-to-date rebalancing plugin I will gladly change the link in the FAQ. But it is too much work for me right now to create such a plugin myself.
I need your help friend, if you could help me I would be very grateful and I would donate you money
I really love your plugin
but....
what happens is that in version 1.13 the plugin does not work for me, it comes out in red letters and the folder of the plugin is not created
In reply to enyelninetynine:
You might be using an incompatible version of Shopkeepers. Also make sure that you are using the latest version of 1.13. In either case: Check your server log for errors.
I cannot press on the keeper edit items such as rename, change appearance ,next page ,last page ect. i can add items to the keeper i cannot delete him. I use 1.14.2 bukkit server
In reply to Forge_User_78919081:
Please create an issue over at github and mention the exact versions of Spigot and Shopkeepers you are using. Also check out the server log for errors or info.
Also try to reproduce your issue on a fresh and up-to-date Spigot server without other plugins, to ensure that those are not interferring.
Hey, any way you can add the ability to addon additional currency items?
Maybe even a limitation of 5 or something of that nature.
2 is quite limiting and I would like to open up the ability to use more options.
All around fantastic plugin!!!
In reply to hollowgroundxX:
There is an open ticket regarding this: https://github.com/Shopkeepers/Shopkeepers/issues/502
However, the details of how players would set up their trades is still open. How would players select which currencies to use? Currently each available trading slot corresponds to one currency.
In reply to blablubb:
Absolutely. I discovered the trades shop not too long after writing the previous comment. The plugin is fantastic.
Sorry for the confusion.
Hey @blablubb
Could you add an option for stopping shopkeepers from staring at vanished players? :l
May get a bit tricky when it comes to citizen + shopkeeper combinations... where I guess it would be citizen's responsability.
In reply to MithrandirMage:
I simply invoke minecraft's 'look-at-nearby-players' behavior, so changing this is a bit tricky / prone to issue on minecraft updates. I also assume that you would still have the same issue for all other mobs, not just the shopkeepers.
I looked through the minecraft bug tracker, to find out whether this has already been brought up, and I found this: https://bugs.mojang.com/browse/MC-116969 . However, I tested this on 1.14.3 and mobs will still look at nearby invisible mobs.
Edit: Which 'vanishing' plugin are you using?
In reply to blablubb:
PremiumVanish
In reply to MithrandirMage:
According to their plugin page they don't even use Bukkit's system for hiding players, but filter packets manually. There seems to be an option to put vanished players into spectator mode though. If you turn that on, all mobs, including the shopkeepers, should ignore your vanished players then.
Hello, I have used this plugin years ago and it worked perfectly, but now I tried making a server again, but the plugin doesn't seem to work for 1.14.. whenever I try to do a command I get this:
An internal error occurred while attempting to perform this command.
In reply to Forge_User_90545625:
Open a ticket over at github and attach your server log there.
Also make sure that you are using the correct version of both Spigot and Shopkeepers. For instance, Shopkeepers v2.7.2 (not yet available) only supports the very latest version of Spigot 1.14.3, while the other versions of Shopkeepers don't suppport 1.14.3 at all.
In reply to blablubb:
Yeah that seem to have fixed it, I was trying to use the version v2.7.2 with Spigot 1.14, thank you for the fast response.