Player Shops

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.
This Page is Outdated and Needs Updates. Consult the information below with a grain of salt as it may not be accurate or contain outdated information.

Player Marketplace

The Player Marketplace can be found under the warp menu using /warps or by typing /marketplace.
The Player Market is a completely player run location. Players build the shops and sell their own items, so you can shop around to see what other players have for sale, or see who has the best deal on the blocks you may be after.

Player Marketplace Rules

In order to make sure that the player marketplace is a safe and fun area for everyone to participate in, here are some rules for using the marketplace.
  1. 1.
    Respect the space of other players. Make sure that you don't encroach on another users shop. If you plan to build a larger shop, do it farther away from others so that you don't take up space of another smaller shop owner.
  2. 2.
    Spinel's must be the primary currency in your shop. Selling/Buying shops are already locked to only use Spinels as the currency, but if you plan to create a Trading Shop, make sure that your primary currency is Spinels, or that you have other villagers setup as buying/selling villagers that accept Spinels as payment. We want to help stimulate the economy of Spinels, and ensuring that players are on board with using them as a currency is an important measure to take. On average, less than 15% of your shops should use trading villagers. The Moderator team will check shops occasionally to make sure you are following these rules, and if you aren't you may be asked to change your shop.
  3. 3.
    Emeralds are a banned currency at the Marketplace. Because getting Emeralds can be incredibly easy, especially for those that have large villager trading halls, Emeralds are a banned currency at the Marketplace. You must use Spinels as your primary currency. If you wish to sell items for Emeralds, you can do so by creating a shop at your base or another location in the world, but not at the Player Marketplace.
  4. 4.
    All griefing rules apply at the marketplace. All the rules from our general rules page apply at the Player Market. Don't grief something, even if it's unclaimed. If it doesn't belong to you, don't touch it!
  5. 5.
    Do not complain to Mods/Admins about pricing. We do not run the shops, we do not set their prices. If a player decides to sell something for an absurd price, that is their prerogative. You can engage with a civil discussion about it, or accept that its their price. Do not complain the Mods about it. They will not change the pricing for you.
  6. 6.
    Clue Scrolls can not be re-sold by Players.

Creating Villager Shopkeepers

Visit the Marketplace and Speak with Horatio. He will sell you a Villager Shopkeeper Creation Tool for 5 Spinels. You can use this to create a custom villager that will handle all of your trades for you. You must deposit your stock into a chest, then link your villager with the chest. Set the pricing, and then let your villager do all the work for you!
There are different types of player shops with slight differences in how their trades are set up.

Selling Shop

This shopkeeper sells items for currency items.
First, place the items you wish to sell into the chest. In order to sell written books you must use the special book shopkeeper.
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.
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.
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 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. A buying shopkeeper can only buy basic items, not enchanted items, books, or maps.

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.
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.

Editing Shops

Once you have created your shop, there are various actions you can perform to either customize your shop further, or delete it again. This page describes how editing of shops works in general, and what the available actions common to all shop types are.

Opening the "Editor Window"

By right-clicking on the shopkeeper while sneaking, you can open the shop's "Editor Window". This will look like a regular chest inventory, but it has a couple of special icons. Those represent buttons you can click to perform certain actions on the shopkeeper.
Example of the (empty) shop editor window:

Renaming the shop

To set the shop's name, click the name tag and then type the new name into the chat.
The new name gets verified using a regular expression specified in the config. This regular expression specifies the allowed characters, as well as the allowed minimum and maximum length of the name.

Changing the object variant

Some shop object types provide multiple variants you can select from inside the editor window. For example, for a villager shopkeeper you can cycle through the various villager professions and biome types by clicking the corresponding items.

Deleting the shop

If you want to delete the shopkeeper, you can click on the bone in the bottom-right corner. Be careful, there is no undo!

Setting up trades

The setup of trades works differently for each shop type. Information on that can be found above.