# 🏪 Shopkeepers

### 🏪 Master the Market: Shopkeepers Guide

Shopkeepers are the backbone of the Zoralis economy, allowing you to run automated stores that trade, buy, or sell even while you’re offline.

***

{% hint style="info" icon="sunglasses" %}
Active Shopkeepers: All shopkeepers must be in use and not kept in chests. If you no longer need your shopkeeper, you must return it to staff for later use.
{% endhint %}

#### 🛠️ Shopkeeper Setup Guide

Follow these 6 simple steps to launch your business:

1. Prepare the Stock: Place a Chest or Barrel anywhere within your 11x11 plot.
2. Grab Your Tool: Hold your Shopkeeper Spawn Egg in your hand.
3. Link the Shop: Right-click the chest you placed to link your villager to that inventory.
4. Choose Your Business Model: Once linked, select one of three shop types:
   * 💰 Sell Shop: You provide items; players pay you.
   * 📥 Buy Shop: You provide the payment; players sell items to you.
   * 🔄 Trade Shop: Direct item-for-item bartering.
5. Configure Trades: Open the Shopkeeper interface to access the Trade Editor.
6. Set Prices: Place your "Cost" items and "Product" items in the editor slots and save.

***

#### ⚙️ Managing Your Shop

Need to make adjustments? You can edit your shop settings at any time.

* Open Editor: Sneak (Shift) + Right-click your Shopkeeper.
* Switch Types: Use the Type Selector icon inside the editor menu to swap between Sell, Buy, or Trade modes.
* Move Your Shopkeeper: You can adjust the villager’s position or appearance within the editor menu to fit your shop’s aesthetic.

***

#### 💡 Merchant Tips

* Inventory Management: Make sure your linked chest is always stocked! If a Sell Shop runs out of items, the trades will be disabled automatically.
* Visual Appeal: Use the editor to change your Shopkeeper’s profession or clothing to match your shop's theme.
* Safe Trading: Shopkeepers are admin-protected, meaning your stock and earnings are always secure from theft.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ashblossom.gitbook.io/help/zoralis-market/shopkeepers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
