Shopkeepers

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

Creating a Shopkeeper

To create a shop, you must look at a recently placed chest 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. This villager does not move and simply stays at this location to offer your trades. This will also protect your chest even if the area is unclaimed.

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, is for the items shown 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, 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.

To stop selling an item, simply right click to decrease the cost until the cost is no longer there.

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 allow toggling between adult and baby variants, as well as the profession and level of villagers. This can be useful for using professions and looks to fit a theme, or the items being sold.

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, trades will fail, even if it would "empty" a lot in the transaction.