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 B. |
| BadWolfMC | Michael M. | Alejandro A. |
| Michael B. |
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: https://github.com/Shopkeepers/Shopkeepers-Wiki/wiki/Add-On-Plugins
If you have also written an add-on plugin that you want to add to the list, let me know!

-
View User Profile
-
Send Message
Posted Mar 11, 2015@NathanWolf
Hm, I am currently not sure what could cause this..
I am calling:
This method was added in spigot's craftbukkit recently. If you are running 1_8_R2, as your log says, then this method should be available there..
I just tested this code on my test server and it run fine (though I am 14 versions behind currently).
You could try if you can reliable trigger this error on your server if you setup a trade which involve items with metadata and then attempt to trade a matching item (so it has to execute all item meta comparison code first).
Maybe also try with a different spigot/craftbukkit build, in case something was messed up in your build for some reason.
-
View User Profile
-
Send Message
Posted Mar 11, 2015Do you know what this error might be?
http://pastebin.com/DFuvzcfC
I'm honestly not sure when it happened or if it caused any issues, I just saw it fly by in my server logs.
Love your plugin, as always!
-
View User Profile
-
Send Message
Posted Mar 10, 2015@res83
If you are using citizens you can create npc shopkeepers and you can change their skin and the item hold in hand via citizens commands.
The shopkeeper plugin doesn't have this functionality.
-
View User Profile
-
Send Message
Posted Mar 10, 2015Good evening, I would like if possible to change the skin to Shopkeepers possible.
And that may have an item in hand.
Thanks I really like this Plugin
-
View User Profile
-
Send Message
Posted Mar 8, 2015I'd love to see bunnies added to shopkeeper entities list... I love bunnies. :3
-
View User Profile
-
Send Message
Posted Mar 8, 2015@Goldtank
What? This is a craftbukkit plugin. You can run it everywhere where craftbukkit is running.
-
View User Profile
-
Send Message
Posted Mar 8, 2015@blablubbabc
do this plugin work for single player to?
-
View User Profile
-
Send Message
Posted Mar 8, 2015Do this plugin work for single player?
-
View User Profile
-
Send Message
Posted Mar 7, 2015Amazing work as always!!! A massive thanks!
-
View User Profile
-
Send Message
Posted Mar 7, 2015v1.50 for MC 1.6.2, 1.7.x, 1.8.x
Some of those entities (currently: bat, ender_dragon, wither, enderman, silverfish) get the new NoAI entity tag set in order to prevent the biggest issues with them: As this new tag is only available on MC 1.8 you should only enabled those if you are running on MC 1.8.x.
Currently known issues with those new entity types (there might be more issues.. usage on own risk):
-
View User Profile
-
Send Message
Posted Mar 6, 2015Is it possible to pay with Experience Levels? If not, it would be a great update!!
-
View User Profile
-
Send Message
Posted Mar 5, 2015@AetharanLevesque
Well, that's not possible right now and I currently have no plans adding something like that..
-
View User Profile
-
Send Message
Posted Mar 5, 2015@blablubbabc
Every guild has their own shopkeeper, and now only the guildmaster can access the chest. We want to make everyone able to open the chest and put a key to the chest,so only the guildmembers with the key will be able to open it.
Thanks for the help.
-
View User Profile
-
Send Message
Posted Mar 5, 2015@AetharanLevesque
There is no mechanism built-in with which you can grant certain players access to the shopkeeper.
You could given everyone the shopkeeper.bypass permission node. This however would give them a bunch of other bypasses as well: they could modify the shopkeeper, remove it, set it for hire, transfer it, and they could bypass the 'prevent-shop-creation-item-regular-usage' setting from the config.
Not sure what sense the shopkeepers would have on your server when everyone has access to the chest anyways..
-
View User Profile
-
Send Message
Posted Mar 5, 2015Hello, can someone tell me what can I do to allow everyone in the server to have access to a shopkeeper linked chest? We're using shopkeepers in group and we protect the chests with a key plugin. Is there a way?
Thank you all for developing this awesome plugin.
-
View User Profile
-
Send Message
Posted Mar 4, 2015just keep getting better with each update.
-
View User Profile
-
Send Message
Posted Mar 4, 2015@Jikoo_K
v1.49 for MC 1.6.2, 1.7.x, 1.8.x
-
View User Profile
-
Send Message
Posted Mar 4, 2015Would it be possible to make shopkeepers unaffected by splash invisibility potions?
-
View User Profile
-
Send Message
Posted Mar 4, 2015v1.48 for MC 1.6.2, 1.7.x, 1.8.x
Create a backup of your save.yml file and make sure that the permissions are setup correctly and actually work correctly before using, because the newly added remove commands are potentially dangerous.
-
View User Profile
-
Send Message
Posted Mar 1, 2015@blablubbabc
thanks!