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!
Comments
-
blablubb Owner
-
_ForgeUser8274522 Author
-
_ForgeUser9352339 Translator
-
nisovin Author
-
View User Profile
-
Send Message
Posted Nov 21, 2014@andyhan123
This is impossible with craftbukkit as they're an entity and you can't go through them
-
View User Profile
-
Send Message
Posted Nov 20, 2014v1.27 Alpha for MC 1.7.8+
This is an alpha version:
While this version seems to work quite well already, there might be some new bugs being introduced due to some internal changes.
Also there are some issues which still need to be resolved (hopefully no breaking issues though..) and some new features to test out.
Also please see the changelog of these previous versions!
-
View User Profile
-
Send Message
Posted Nov 20, 2014Great Plugin!
greetings Premx
-
View User Profile
-
Send Message
Posted Nov 19, 2014v1.26 Alpha for MC 1.7.8+
This is an alpha version:
While this version seems to work quite well already, there might be some new bugs being introduced due to some internal changes.
Also there are some issues which still need to be resolved (hopefully no breaking issues though..) and some new features to test out.
Also please see the changelog of these previous versions!
-
View User Profile
-
Send Message
Posted Nov 15, 2014@andyhan123
Unfortunly there is no possibility for this I know of inside bukkit's api.. However normally the shopkeepers should get teleported back to their original location every 10 seconds if necessary. So if that doesn't work for some reason it would make more sense for me trying to find out why it doesn't work for you..
If you enable debug mode in the config you should get a message in the console everytime a shopkeeper gets teleported back to it's original location. Check if you get those messages after you have pushed a shopkeeper entity around.
What worldguard thing are you talking about?
Generally the shopkeeper can't be interacted with if some other plugin interferes (outside the worldguard region in your case). If you have turned on debug mode you should get a message in the console everytime some player tries to interact with a shopkeeper but gets blocked by some other plugin.
However there is a setting inside shopkeeper's config which causes the shopkeepers to regardless of other plugins allow interaction with them. So you could either try to find out which of your plugins are causing issues (maybe you have configured worldguard to disallow the interaction by default) and fix it there or try out that setting in the config of shopkeepers.
-
View User Profile
-
Send Message
Posted Nov 15, 2014Can you please make the shopkeepers unpushable, because on one of my servers they can be pushed and do not teleport back for some reason. Also with this new worldguard thing I have to make a small region where players can right click the shopkeeper, but people keep pushing them out of that area.
-
View User Profile
-
Send Message
Posted Nov 12, 2014@Trustinlies
Nope, but if the shopkeeper command gets replaced by your buycraft command (do they really have this as official command?) you could take a look into creating command aliases. I think there is some way built into bukkit directly for server admins to create command aliases, alternatively there are plugins out there which try to accomplish command aliasing as well. Note that there also already is a built-in command alias: you can both use 'shopkeeper' and 'shopkeepers' (with the 's' at the end) to create admin shopkeepers.
-
View User Profile
-
Send Message
Posted Nov 12, 2014is there a way to modify the command that needs to be run? shopkeeper is currently conflicting with our servers buycraft settings.
-
View User Profile
-
Send Message
Posted Nov 12, 2014@broluigi
Right now I have no plans to do so. What do you mean by special items?
@Dillzzzzz
Which server version are you using?
-
View User Profile
-
Send Message
Posted Nov 12, 2014It says I need to update..wot spamming my console
-
View User Profile
-
Send Message
Posted Nov 11, 2014can you make it so we can stock a villager with multiple goods? before they reach the trade screen, they choose what list they want to see?
I have a system where people use special items to trade for others, but dont want hundreads of villagers to facilitate it. Can you please make it so i can have 1 villager trade 100's of items? Sort of like ultratrader but not economy money, items!
-
View User Profile
-
Send Message
Posted Nov 11, 2014@blablubbabc
Now it works perfectly! :) Thank you.
-
View User Profile
-
Send Message
Posted Nov 9, 2014@Adurath
First make sure you have enabled it in the config. The setting for that is called 'enable-citizen-shops'.
Then if you type the command ("/shopkeeper citizen") and you are an admin it will spawn an admin shopkeeper with mob type villager, but still being a npc. You can select the shopkeeper npc with a stick and change it's type to whatever you want via citizens commands ("/noc type <mobtype>").
If a player creates a citizens shopkeeper (via the spawn eggs) it will be a player shopkeeper and the mob type will be locked to a player type npc with the player's name (at least in it's current state there is no way fpr normal players to change the npc mob types of the shopkeepers spawned that way).
-
View User Profile
-
Send Message
Posted Nov 9, 2014@blablubbabc
I have tested it, but it does not work. :o Its only create a villager :D
-
View User Profile
-
Send Message
Posted Nov 8, 2014@Adurath
There is experimental support for citizens shopkeepers, yes.
You can sspawn them via "/shopkeeper citizen" and then modify the citizen npc via citizens commands.
-
View User Profile
-
Send Message
Posted Nov 8, 2014Hey,
support shopkeepers citizens? in my option are villager very ugly :,D How do it?
regards
-
View User Profile
-
Send Message
Posted Oct 26, 2014@blablubbabc
I will be opening a ticket, and analizing the symptoms further if it happens again.
Luckily I always have some backups just in case :)
What I really wish for is better head compatibility with shops xD I guess whith all the rumble going on on Bukkit + Spigot lately there isn't much to be done about it :(
Reminder:
http://dev.bukkit.org/bukkit-plugins/shopkeepers/tickets/256-shopkeepers-v1-25-bug-report/
-
View User Profile
-
Send Message
Posted Oct 24, 2014@Hazl51
I will probably look into compatibility for glowstone once glowstone is in a state of supporting basic things like villagers, setting up trades etc.
Glowstone is currently missing too much stuff which is needed for Shopkeepers to work.
-
View User Profile
-
Send Message
Posted Oct 24, 2014Hello.
I'm want test Glowstone server with your plugins but it's dont work. can you update your plugin to work with Glowstone server ?
---09:56:56 [INFOS] [Shopkeepers] Enabling Shopkeepers v1.25 09:56:56 [GRAVE] [Shopkeepers] Potentially incompatible server version: glowstone 09:56:57 [GRAVE] [Shopkeepers] Shopkeepers is trying to run in 'compatibility mode'. 09:56:57 [INFOS] [Shopkeepers] Check for updates at http://dev.bukkit.org/bukkit-plugins/shopkeepers/ 09:56:57 [GRAVE] [Shopkeepers] Incompatible server version: Shopkeepers cannot be enabled.---http://www.glowstone.net/downloads/
-
View User Profile
-
Send Message
Posted Oct 23, 2014@MasterMithrandir
Yes please create a ticket. Also go through your logs and see if you can find any errors, warnings, crashes and similar ..
Also let me know there if you did change anything on your server setup (server, plugins, configurations etc.) the last days before this started happening.
A possible situation in which the save.yml gets wiped is if the plugin cannot properly load it. If certain shopkeeper data can not be loaded those shopkeeper-sections get wiped.
Did you manually edit your save file?
However duplicating shopkeepers would mean the issue is likely something else..