Shopkeepers

logo

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.

Basic Features

  • Easily create villager shopkeepers, trading 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 citizen (npc) shops.
  • 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, 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:

Showcase

Admin shops:

Configuring the trades via in-game inventory menu:

setup-admin-shop-text

Resulting trading menu:

setup-admin-shop-result

Player shops (ex. selling items):

Filling chest with supplies:

setup-player-shop-sell-chest

Configuring the trades via in-game inventory menu:

setup-player-shop-sell-text

Resulting trading menu:

setup-player-shop-sell-result

Video Tutorials

Tutorial showing how to setup the trading player-shopkeepers: https:www.youtube.com/watch?v=5E2lOQQ_mPQ

And another tutorial with images by Mouro001: imgur.com/82NnbPU

An old but still good tutorial provided by TrowbridgeHD/RyanDT13:

Having issues or further questions

Check if your question is already answered in the documentation or, especially, the FAQ.

Also check out if there is already an existing issue ticket for your issue. And if not, create one.

Troubleshooting and reporting Issues:

Before reporting: Try if you can reproduce your issue when using a freshly setup server using the latest version of Spigot, Shopkeepers (with default configuration), and no other plugins. This can already give insights on whether your server version or another plugin is involved in the issue.

When reporting: Please provide the versions you are using of both Craftbukkit/Spigot and Shopkeepers, and thoroughly describe the problem you are having, including step-by-step instructions on how to reproduce the problem. Provide as much information as possible, which could help reproducing the issue on a freshly setup server.

Known potential issues:

  • If the trade for a written book fails players can sometimes still open and read the book if they close the shop and click the temporary fake book in their inventory fast enough. There is not much I can do about this.
  • Server crashes and improper shutdowns might cause living non-citizens shopkeeper entities to duplicate sometimes.
  • The 'always-show-nameplates' setting is no longer working on MC 1.8.
  • Compatibility with older bukkit versions is untested. If you encounter any problems let me know and I will look into it.
  • A bunch of entity types are only meant for experimental usage. They might cause all kinds of issues if used. See changelog of v1.50.
  • In the latest MC 1.8.x versions default minecraft trading logic has slightly changed (and by that those of shopkeepers as well): If a trade requires an item with special data (like a custom name, etc.) minecraft is now only allowing this trade, if the offered item is perfectly matching, including all special item data and attributes.
  • On MC 1.9 and MC 1.10 any spawn egg type is accepted as shop creation item. If you are updating, you may have to change the data value to '0' in the config for spawn eggs to work at all. For 1.11 and later there is a new config setting to specifiy the spawn egg mob type (see changelog of v1.83).
  • Shopkeepers using skeleton or zombie variants after updating to MC 1.11 or above can not be loaded again (will be lost) when switching back to a previous minecraft version.
  • If you are running on a minecraft version below MC 1.11, you can no longer cycle through the different zombie variants and skeleton variants. Existing shopkeepers using those will fallback to normal zombies and skeletons.

Donations

If you like this plugin, consider supporting its developers by making a donation:

Thanks!

Want to help? Looking for a documenter!

I am looking for someone who would be willing to actively get involved in the project.
Currently that would mostly mean helping me with keeping the documentation (the wiki) up-to-date / improving it. But if you are a programmer experienced with bukkit plugins, or have ideas on how you can contribute to the project beyond that, let me know!
If you are interested, feel free to contact me via PM.

 


Comments

  • To post a comment, please or register a new account.
Posts Quoted:
Reply
Clear All Quotes

About This Project

Categories

Members

Recent Files

Bukkit