Player Shop Setup - Shopkeepers/Shopkeepers-Wiki GitHub Wiki

This page describes setup and editing procedures specific to the different types of player shops. For information about editing shops in general see Editing Shops.

There are different types of player shops with slight differences in how their trades are set up. You can specify the currency items used for the selling and buying player shops in the configuration.

Selling Shop

This shopkeeper sells items for currency items.

First, place the items you wish to sell into the chest. By using Placeholder Items, you can also setup trades for items that you don't own yet. In order to sell written books you must use the special book shopkeeper.

images/setup/setup-player-shop-sell-chest.png

Now open the editor window. The top row will show the various item types for sale from the chest. The bottom rows will show the costs of those items. If no costs have been specified yet, there will be barrier placeholders. To modify the cost, left-click the cost slots to increase the cost, and right-click to decrease the cost. You can also hold shift while clicking to modify the cost by 10 at a time. You can adjust the quantity of the sold items in the same way with left and right clicks.

The buttons in the forth row can be used to switch between multiple pages of trades. You can setup up to 5 pages with a total of 45 trades per shopkeeper.

images/setup/setup-player-shop-sell-text.png

Once the costs are all set up, just close the window to save.

When a player purchases an item from a player shopkeeper, the item in the chest will be removed and the currency items used to purchase will be added. When a player purchases the final stack of a certain item, the trade will be disabled. If a player attempts to make a purchase when the chest is out of stock or has not enough space to hold the currency items, the trade will fail.

Buying Shop

This shopkeeper buys items for currency items.

Usually, you can only buy items that you already own at least one of. However, you can also use renamed nametag items as substitutes for items that you don't have. See Placeholder Items.

First, you must place at least one of each type of item you want to buy into the chest, as well as plenty of currency items. Then, when you open the editor window, it works the same as the selling shopkeeper, except that the items you want to buy are at the bottom and the currency is at the top. The slot in the middle is not used.

Note that the more specific the item is you are trying to buy, the less likely it is for other players to be able to sell you an item that matches your requested item. For example, if you try to buy another diamond sword, but the one you currently own has a specific enchantment, any diamond swords that other players try to sell to you will have to contain the exact same enchantment. And if your diamond sword has a specific damage value, any diamonds swords sold to you will also be required to have the exact same damage value.
Consequently, buying shops also don't work well for certain types of unique items, such as specific written books, or map items.

And Minecraft's item matching logic that determines whether or not an item is accepted by a trade also applies in the opposite direction: If you try to buy a regular diamond sword, without any enchantments, players will be to sell you diamonds swords with enchantments. This may even include negative enchantments such as certain types of curses. Buying shops therefore work best for basic items, such as building materials.

Trading Shop

This shopkeeper can trade basically any items you want.

Just like for the selling shop, you insert the items you want to sell into the chest. When you open the editor window, these items will appear at the top. To specify the cost items, you click at some item inside your inventory to pick it up and then at a slot inside the editor window. The item on your cursor will be copied into that slot. You can also insert or replace items in the top row by this.

You can use Placeholder Items to setup trades for items that you don't own yet.

Then left and right click the items to increase or decrease their amount. You can remove trades again by decreasing the amount of the cost items until they disappear.

Book Shop

This shopkeeper sells copies of books.

The setup of the book shop works just like the selling shop, but you put the written books you want to sell into the chest and stock it with book & quill (writable book) items. The shopkeeper will automatically create copies of the sold books. The copied books will have a different generation than their original. You cannot sell books that cannot be copied.

Also note that the books are identified by their title. If you have multiple books with the same title in the chest, it will only use the first book it finds. If you remove the original book from the chest, the trade will be disabled until you add a book with the corresponding title again.