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!
v2.7.2 for MC 1.14.3
Checkout the changelog of v2.7.0 regarding the update to MC 1.14.
Known potential issues: See here.
Donations
If you like this plugin, consider making a donation.
Thanks!
Thanks to all donations since the last update:
Hello from Hong Kong. I think your plugin is unique and I would like to add into my server, however, errors kept appearing in console everytime I interact with the shopkeeper.
The error is: [Server thread/ERROR]: Could not pass event InventoryClickEvent to Shopkeepers v2.6.0
org.bukkit.event.EventException: null
...blablabla
Caused by: java.lang.NoSuchMethodError: org.bukkit.inventory.Inventory.getTitle()Ljava/lang/String;
I am able to create a new shopkeeper with /shopkeeper, but no responds after I entered the shopkeeper editor, I can't change its name nor delete it, then I found the error in console.
I hope you can troubleshoot what is going on, and thank you for your effort :)
Minecraft and craftbukkit version: 1.14.2
P.S: I have tried to remove all my plugins and the issue is still here.
Hi! I was just wondering if there's a chance you could add command functionality to the shopkeepers where they might be able to play sounds or display text when a player opens the shop menu, purchases an item, or leaves without making a purchase. I think that could add a nice little bit of polish to an already fantastic plugin!
In reply to sketchycosmos:
Consider creating a ticket over at github for your suggestions and try to concretize them as much as possible.
Keep in mind:
* I am trying to avoid commands as much as possible and would prefer a solution that works intuitively via editor options.
* I try to keep the number of editor options/commands down to the essentials.
* Some of these might be possible via citizens shopkeepers (though, nothing that would interact with the trading mechanics)
* To not conflict with the above points, maybe it would make sense to considers adding these citizens-like features as part of a separate 'addon' plugin (so the regular users, which I assume would not make use of such role-playing features or are served fine already by the citizens-features, are not bothered with these commands/options).
* I might not have the time to look into these rather specific features.
Hello,
On our server we use your plugin since a lot of years. Never disappointed by these features, we're happy to saw all of update made.
I have one question about upgrading to 1.14 after updating the plugin, will Shopkeepers keep their exchange and their location ?
Thanks !
In reply to Forge_User_75841583:
If everything works fine, then yes, the shopkeepers should keep their trades and locations. Just for the case that something is breaking, make sure to keep a backup of your shopkeepers data.
Hi! I was wondering if there´'s a way of copying the shoopkeepers or move them to another world.
In reply to Forge_User_93221230:
Nope, not built-in. If this is a one-time thing, you could however copy them manually by modifying the save.yml (change the shopkeeper's world and coordinates). Be careful though to not corrupt the save.yml file in the process. Make a backup of it first, and ensure that the server isn't running while doing this.
Help
In reply to arturo_atomplay:
v2.6.0 is not compatible with MC 1.14. You have to use v2.7.x. See the uploaded files for an overview of all available versions and their compatibility.
If you setup a trade with a villager that includes items that were renamed and custom edited(modified some of its stats such as damage using command blocks) using command blocks then if you try trading with the villager once the trade is up, the villager will not trade with you and you will get the item you were trading back at your inventory like no trade took place.If you edit the villager and exit the editing menu and try trading again,the villager will now be able to trade with you.
Thank you.
There's an incompatibility issue with the SilkSpawners plugin where if you set a player shop selling a Spawner given by the plugin, after some time it will disappear from the shopkeeper menu, but the item was never sold (still in chest)
In reply to zaino60:
Initial guess: Probably not an issue of Shopkeepers, but either:
* SilkSpawners creating irregular items that get normalized by minecraft or spigot at some later point (eg. chunk loading the chest)
* Spigot's item serialization not reproducing the originally saved item for these (custom?) mob spawners.
Anyways, I need to be able to reproduce this in order to further look into it.
Which version of Spigot, Shopkeepers and SilkSpawners (this: https://dev.bukkit.org/projects/silkspawners ?) are you using?
Can you provide step-by-step instruction how I have to configure and use SilkSpawners to reproduce this issue?
* Any derivations from the default config required?
* Is this happening with any type of mob spawner?
* How do you get/create the mob spawner item using SilkSpawners (which commands to use, silktouch mining a regular mob spawner, ..)?
"after some time it will disappear"
Can you narrow this down? Is this happening on plugin reloads, server restarts, chunk reloads (leaving the area and later coming back), .. ?
Ideally create a ticket over at github.
In reply to blablubb:
Issue created on github :)
I'm on 1.13.1 using version 2.4.1 and the shopkeepers plugin is red/isn't loading.
In reply to The_ApolloGaming:
Check your server log for errors / warnings.
I also suggest updating to the latest version of Spigot 1.13.x and the latest compatible version of Shopkeepers, which is v2.6.0.
It won't let me drag any items into the trader.
In reply to The_ApolloGaming:
Please create a ticket and provide a more detailed description of your issue:
What type of shopkeeper are you having issues with (admin, player)? From where to where are you trying to move items?
Which versions of Shopkeeper and Spigot are you using? Any errors in your server log, or additional information when you turn on debug mode?
In reply to blablubb:
I'm using admin shops. I'm trying to move items from my inventory to the shopkeepers inventory so people can trade with them. I'm using shopkeeper 2.7.0 because 2.7.1 I had the issue where I was just taking the items also. And I'm using the most recent version of spigot (1.14.2).
In reply to The_ApolloGaming:
"I'm using shopkeeper 2.7.0 because 2.7.1 I had the issue where I was just taking the items also. And I'm using the most recent version of spigot (1.14.2)."
I just tested v2.7.1 with the latest version of Spigot and I cannot reproduce any of these mentioned issues, neither with the admin nor the player shopkeeper. Also, the changes in v2.7.1 should have no impact on the shopkeeper trading or editor behavior.. If they do then I suspect that you might not be using the latest version of Spigot, or you are not using Spigot at all (maybe you are using Paper instead?).
Can you post the exact Spigot version you are using (output of /version command)? The command should also tell you if you are not up-to-date.
The latest version right now is: git-Spigot-baafee9-7cc7719
Also make sure that you try to reproduce your issue(s) without any other plugins on the server, to ensure that the issue isn't caused by interference between different plugins.