# Shop Starter Guide

***

#### 🧪 What You’ll Need

Before setting up your shop, make sure you have the following:

* **Villager Spawn Egg** (buy at spawn: `-0, 126, -10`)
* **Chest** to store your inventory
* A **claimed area** (highly recommended to prevent griefing)

> 💰 Villager eggs are purchased using **Diamonds** and **Gold Blocks**. Quantities vary.

***

#### 🏗️ Setting Up Your Shop

1. Choose where you want your shop to be.
2. Place a **chest** to hold your shop items.
3. *(Optional)* Decorate your store with a stall or structure.
4. Hold your **Villager Spawn Egg** and **right-click the chest** to link it.
5. Then, **right-click the ground** where you want the villager to spawn.

🎉 You’ve now got a working player shop!

***

#### 📦 Stocking and Pricing Items

Let’s say you're selling **planks, cobblestone, stone, and diamonds**:

1. Place your items into the **linked chest** — stacks recommended!
2. **Shift+Right-click** the villager to open the **Shopkeeper Editor**.
3. Use the editor:
   * **Top row**: Items for sale
   * **Middle rows**: Items customers must pay (e.g., emeralds)
   * **Bottom row**: Customize your villager (appearance, name, etc.)
4. Set your prices. Example:
   * 32 Planks → 3 Emeralds
   * 64 Cobblestone → 2 Emeralds
   * 16 Stone → 1 Emerald
   * 3 Diamonds → 4 Emerald Blocks

🧾 Each Shopkeeper can have **5 pages** with **8 listings per page** (up to 40 items total).

💸 All earnings (Emeralds) go into the chest.

> ❌ If an item runs out, a red ❌ will appear in the villager’s menu.

***

### 🏙️ Renting a Market Stall

These are coming soon.

***

### 💬 Need More Help?

If you're stuck or need more guidance:

* Ask in our [**community Discord**](https://discord.asurvivalserver.net/) — friendly players are happy to help!
* Or check out tutorial videos like those by Minecraft YouTuber **Donnie** *(not affiliated with our server)*.

{% embed url="<https://www.youtube.com/watch?v=t51LIXbf7Bs>" %}

***

🏪 **Happy shopkeeping, and welcome to the economy of A Survival Server!**


---

# 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://docs.asurvivalserver.net/player-guides/shop-starter-guide.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.