Shopkeepers

The Shopkeepers plugin allows you to create chest-based shops with an NPC shopkeeper. The shopkeeper can then be configured to offer trades to other players, even while you are offline.

Creating a Shopkeeper

To create a shop, look at a chest you recently placed and use the command /shopkeeper. This will spawn your shopkeeper - a villager - on the side of the chest you were looking at. This can also be on top of the chest.

Mobs other than villagers can also be used as shopkeepers. Providing a mob type in the shopkeeper command (/shopkeeper <type>) will create a shopkeeper of that type. Not all mob types are available, but many of them are.

Regardless of the mob type, shopkeepers exist only to offer trades for your shop. They have no AI and will not move from the spot they were created at.

Creating Trades

To create trades you firstly need to place the items you want to sell in the shopkeeper's chest. For example, if you're selling wood you need to put at least 1 wood in the chest to setup the trade.

Next you need to sneak + right click on your shopkeeper. This will open the Shopkeeper Editor to setup the shop.

The first row, shown in red, isshows forall the unique items showncontained in the chest, which you can offer trades for.

The third row, shown in green, is the primary cost for the trade, which is the first item a buyer will need to complete the trade. The second row, shown in blue, is an optional secondary cost. This is the second item a buyer will need to complete the trade.

Once an item has been placed in any of the above slots,rows, its quantity can be increased by 1 with left clicking, and decreased by 1 with right-clicking. Shift + clicking will increase / decrease the amount by 10 at a time.

The books to the left and right, shown in pink, can be clicked as needed to switch between pages, to sell more than nine items.

ToOnly stopitems sellingwith costs will be offered as trades. Decreasing an item,item's simply right clickcost to decrease0 thewill costhide untilit thefrom costtrading is no longer there.players.

Customising Shopkeepers

The appearance of the shopkeeper can be customised with the buttons at the bottom of the Shopkeeper Editor, shown in red below. These buttons will vary based on the mob type of the shopkeeper, Villagers will have buttons to set their profession and level and age, while other mobs may have buttons for age and appearance, or nothing at all.

Shopkeepers can be named by using a nametag. Their name will be displayed above them at all times, in green.

Deleting Shopkeepers

To delete a shop, click on the bone in the bottom right corner of the Shopkeeper Editor.

This will remove the shopkeeper and leave the chest unprotected, the items within the chest will not be lost. Any trades created will be lost.

Using Shopkeepers

To use a shop, right click the corresponding shopkeeper. This will open their trade UI, which will show the shop owner's trades. Trading with the shop works the same as trading with a villager; select a trade from the list on the left, provide the required items, and retrieve the resulting item from the right.

You cannot trade with your own shops.

Miscellaneous notes

At present this plugin does not inform users if a trade has happened, or if you are out of stock. Thus, it is recommended to check your shop stock when you can.

It is advised to leave an empty slot within the chest, so trades can still successfully happen. If a chest if 100% full, all trade attempts will fail.