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!
....
Since the latest version of minecraft and this plugin came out we have not been able to place any new shopkeepers. It says "Cannot place shopkeeper here", but like in every place it says that no matter where you are.
But thank you so much for your work on this. It's been a great addition to our server. I hope it works again though.
None of my shopkeepers keep NBT tagged items? I can't sell Enchant Books, Player Heads, or Magic Scrolls from the Nisovin's MagicSpells plugin.
fyi, i really appeciate all the work you put in on the mod, its very useful and very cool
on my server there are many issues with it so i have made a ton of changes to a copy of your project
i removed the recent timer
removed most of the shop types except trade
removed the restriction on selling the currency type
removed the restriction on selling books
im making the items work with the new name tax, and enchantment books (not done)
made the vendors show you the inventory of your chest for convenience
made the mod not protect breaking or opening of the chests
made the vendors killable if their chests are broken
removed the check for recent placement
made regular villagers hire able with a configurable currency (turns them to an egg)
made it so you can trade with your own shop (to test at least)
i hope this is alright with you, i wont be releasing it or trying to take any credit for your work
im also still tinkering on it
i have done somewhat sloppy edits on most of it because i am tailoring it only for my own server
but if your interested in any of the changes let me know and i can share the repository with you
thanks
can you make options for allowing use on chests that arent recently placed
and also for allowing players to trade at their own shops (why is this disabled anyway?)
and also a new feature idea, can you make it so if someone uses an emerald (or maybe a configurable currency) on a non-shopkeeper villager, have it put out a string or something that says "you hired a new shopkeeper" and it gives you the egg in your inventory?
i wonder if your planning to add database support
or if there is any concern over the number of shopkeepers being in the hundreds
No possibility of adding adminshop function to signs? :(
@tzeyha11
Hey, don't worry mate people were always a Noob with hosting servers at some point :) The most likely problem here is that the panel Clanforge use is installing an old version of Shopkeepers. If you scroll up this page a bit you'll see that there's many downloadable versions of Shopkeers, each for a different version of minecraft, the version is important. Most plugin before 1.4.5 R1.0 will not work. You'll always want to look for a version for the latest build. Go ahead and download the 1.4.6 R0.3 version and add it to your server manually. Clanforge may have a built in upload system, or you can use an FTP client, that will let you move files to the server host easier. If you need any more help feel free to log into my server at mc.infini-craft.com, I'm Haders on there, if I'm online i'll try my best to help.
Any news on the trades not sticking. anyone have the same issue and or any info to help me fix it i miss this plugin :(. What happens is when you trade something the trade never completes it will change back after around 2 - 3 seconds
Hello,
I know this will be a great plugin and has everything I want so I've been trying for a while now to get this to work and so far I have made no progress.
My server is on Clanforge (and I'm a complete Noob on server anything) I just tried creating a new profile with the following settings:
Game: Minecraft Mod: Minecraft Bukkit 1.4.6 (R.0 .........) Template: Bukkit quickstart Profile Name: LearningServerMinecraft
I created this profile and then made it the active profile in use. I changed the admin name to be my in game name, and set the game password because it was blank and the interface was wanting me to put something there so I did. After this, I have made no additional changes other than installing the ShopKeeper add-on through the clanforge add-on interface. I saved and applied, and everything seemed to be set up correctly. I login to my server to test it out, the first thing you need to do in shopkeeper is create a NPC shopkeeper. So I find the square I want him on and type " /shopkeeper " . A shopkeeper does appear but i also get the following error:
"An Internal Error Occurred While Attempting To Perform This Command"
The shopkeeper stays there, but I can't click on him to configure his settings. I cant do anything with him other than kill him. I tried clicking on him while sneaking (as the plugin requires), and without but it makes no difference. Please help... I'm getting frustrated :(.
I've also asked this next question several times but haven't got an answer on it at all... Can I just pay someone to set it up the way I want it? I only want a couple of simple changes but will pay a good amount to have it done. Please let me know if this is possible either way.
Very much appreciated!
Crystal & Trent
<3 ..
Shopkeepers-1.10-test-2.jar disable-other-villagers no work
Shopkeepers is an amazing shop plugin, please keep it up.
I'm sure you know this but..
Shopkeepers don't sell Fireworks or named heads after a restart, they lose their data.
When I do /shopkeeper I get
I'm afraid I lost my shopkeepers config file in a bad server crash last night. It failed to write and became corrupted, apparently.
Have you considered implememnting MySQL as an option?
@virek2003
...Oh hi.
Just want to say that I love this plugin and I hope you continue to support it. My server's economy actually rely's on its functionality now since we are a 100% emerald based economy.
My only request is that you eventually ad mysql support. Not a fan of flat files, and we have hundreds of shopkeepers.
Firs off I really love your plugin! I am about to test it with multi worlds and will let you know how that goes!
I have one request and I understand that you may not be willing to do this. Is it possible for the villagers to say something when you are within say 6-8 blocks of them?
Thanks again for a great plugin and I hope you are able to consider my request.
Thanks Baffu
Does not create a folder in my plugins or work in game.
I also tried the following but to little avail.
I named an item and gave it lore via the Itemizer plugin because I know it works with this one and I put it into a shop, I then created an empty shop(these are all admin shops if it makes a difference) and then went into the config, copied the text for the shop that worked and pasted it into the blank shop and reloaded the plugin, then tried using the same item:dv named with the same color/format codes using ItemRenamer in the shop and it worked for a little bit but then stopped working several minutes later, it also only worked for some of the trades, not all of them.
@nisovin
I tried with and without, I was able to get one item to "stick" but I can't seem to get any items that use a data value besides 0 to work. If it helps the one that did work was done with me in creative mode.
Edit: From what i've seen the shops still work the item names just aren't displaying correctly
Edit 2: I take that last edit back ._. It seems to be choosing when it wants to work haha. Any idea on why its suddenly doing this? Is it still ProtocolLib doing it like I experienced in the past or is it ItemRenamer or Shopkeepers causing it now? I just need it fixed badly, its the last thing stopping us from updating to 1.4.6 on our main server, our main world and our pvp world both heavily depend on both of these plugins to work.