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

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.

---

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