# ChestShop

**ChestShop** allows players to create physical shops using a chest and a sign. You can use these shops to buy items from other players or sell your own items to them.

### 🛒 How to Use a Shop (As a Customer)

When you see a shop sign, you can interact with it to trade.

#### Controls

* **Right-Click** the sign to **BUY** items from the shop.
* **Left-Click** the sign to **SELL** items to the shop.

#### Reading the Sign

A shop sign has 4 lines of information. Understanding them is key to knowing if you are getting a good deal.

* **Line 1:** The owner's name.
* **Line 2:** The **quantity** of items involved in one click (e.g., `1`, `64`).
* **Line 3:** The price.
  * **B** stands for **Buy** (You pay money to get the item).
  * **S** stands for **Sell** (You give the item to get money).
* **Line 4:** The name of the item.

> **Example Sign:** `PlayerName` `64` `B 100 : S 20` `Diamond`
>
> *This means: You can **Buy** 64 Diamonds for $100, or you can **Sell** 64 Diamonds back to the shop for $20.*

***

### 🏪 How to Create a Shop (As a Shop Owner)

To set up your own shop, you need a chest, a sign, and the items you want to trade.

#### Step 1: Place the Chest

Place a standard chest on the ground. Put the items you want to sell inside it. *(Note: If you are only buying items from players, you can leave the chest empty, but it must have slots available).*

#### Step 2: Place the Sign

Hold a **Sign** and place it on the chest (hold `Shift`/`Crouch` to place it without opening the chest). You can also place the sign on the wall directly above the chest.

#### Step 3: Write the Sign Information

You must format the sign exactly like this:

| Line  | Content         | Explanation                                                            |
| ----- | --------------- | ---------------------------------------------------------------------- |
| **1** | *(Leave Empty)* | The plugin will automatically fill this with your username.            |
| **2** | `Amount`        | The number of items to buy/sell at once (e.g., `1`, `64`).             |
| **3** | `Prices`        | See **Price Syntax** below.                                            |
| **4** | `Item Name`     | The official name of the item (e.g., `Diamond`, `Cobblestone`) or `?`. |

#### Price Syntax (Line 3)

This line determines if people can buy, sell, or both.

* **Selling to players only:** `B <price>` (Example: `B 100` means players pay 100 to buy from you).
* **Buying from players only:** `S <price>` (Example: `S 10` means you pay players 10 to take their items).
* **Both:** `B <buyprice> : S <sellprice>` (Example: `B 100 : S 10`).

{% hint style="info" %}
If you don't know the exact item name (e.g., is it `Oak_Log` or `Oak_Wood`?), put the item inside the chest and write `?` on **Line 4**. The system will autofill the correct name from the chest contents.
{% endhint %}

***

### 🛠️ Important Commands

* `/iteminfo` Hold an item in your hand and type this command to see its correct ID or name for the shop sign.
* `/shopinfo` Look at a shop sign and type this to view details about the shop.

### ⚠️ Common Mistakes

* **The "B/S" Confusion:** Remember that **B** is what the *customer* does (Buy from you). **S** is what the *customer* does (Sell to you).
* **Out of Stock:** If your chest is empty, players cannot buy from you (even if the sign is correct). You will get a notification when your shop is out of stock.
* **Full Chest:** If your chest is full, players cannot sell items to you.


---

# 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://wiki.coldmc.com/dim/overworld/mechanics/chestshop.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.