# Snurbo's Shops
A player-driven shop mod for Fabric 1.21.1, inspired by Donut SMP.
Players can open shops, list items for sale, and buy from each other — all through real in-game chest GUIs with no physical blocks required.
---
## Features
- Real chest GUIs — no custom rendering, no blur, just vanilla Minecraft chests
- Player head browser — `/shops` opens a chest showing every player's head; click to browse their shop
- Buy items — left-click any listing to purchase it
- Sell items — open your own shop, click "+ Add Item", place items, set a price and quantity per sale, then confirm
- Stock is physical — stock equals exactly what you deposited; you can't inflate it
- Restock via double chest — open a listing's edit screen and click "Add Stock" to open a double chest that only accepts the matching item, deposit more anytime
- Quantity per sale — control how many items the buyer receives per purchase (+1/+10/−1/−10 buttons)
- Edit listings — left-click your own listing to adjust price and quantity per sale
- Remove listings — right-click your own listing to remove it and get your remaining stock back
- Out of stock display — sold-out listings show clearly and can't be purchased
- Restock via re-adding — add the same item at the same price via "+ Add Item" and it merges into the existing listing
- Back button — arrow item in the bottom-left always returns you to the shop browser
- Currency mode — optional virtual currency system (op-only to enable)
- Diamond mode — default payment method; buyers pay in physical diamonds
- Auto-pause on currency switch — when an op changes currency mode, every listing across every shop is paused until its owner reviews and re-saves the price, preventing accidental cheap sales at outdated rates
- Scoreboard — when currency mode is on, a live balance sidebar is shown
- Particles & sounds — purchase effects for buyers
## How to Use
### Browsing shops
1. Run `/shops`
2. A chest opens showing player heads — one per player
3. Click any head to browse that player's shop
4. Left-click an item to buy it
5. Click the **← Back** arrow (bottom-left) to return to the browser
### Selling items
1. Run `/shops` then click your own head
2. Click **+ Add Item** (lime glass pane, bottom-center)
3. A staging GUI opens:
- Place items in the **top row**
- Use **Price** buttons (−10/−1/+1/+10) to set your asking price
- Use **Quantity** buttons to set how many items the buyer receives per purchase
- Click the **Emerald Block** to confirm
4. Your listing now appears in your shop
### Editing a listing
1. Open your shop via `/shops`
2. **Left-click** any of your listings to open the edit screen
3. Adjust price or quantity per sale with the +/− buttons
4. Click **📦 Add Stock** to open a real double chest and deposit more of that exact item
5. Click **Save Changes** (Emerald Block) to confirm — this also resumes a paused listing
### Removing a listing
- **Right-click** any of your listings to remove it
- Remaining stock is returned to your inventory automatically
### Restocking
Two ways:
- **Quick way:** open "+ Add Item" and place more of the same item at the same price — it merges automatically
- **Direct way:** left-click the listing → "📦 Add Stock" → a double chest opens that only accepts the matching item type — deposit as much as you want
---
## Currency Mode (Op only)
Enable: `/shops currency true`
Disable: `/shops currency false`
- When enabled, prices are in **$** (virtual money) instead of diamonds
- Every new player starts with **$1000**
- The only way to earn money is by **selling items**
- A sidebar scoreboard shows everyone's balance
- Use `/shops hideboard` to hide it for yourself (only available while currency mode is on)
### ⚠ Important: switching currency modes pauses all shops
Because prices set for diamonds don't make sense as dollars (and vice versa), **every listing on the server is automatically paused** the moment an op changes currency mode. A server-wide message notifies all players. Paused listings show **"⚠ PAUSED"** and cannot be bought.
Shop owners must open each paused listing (left-click it), review/adjust the price for the new currency, and click **Save Changes** to resume selling it. This prevents buyers from snapping up items at prices that no longer make sense after a currency switch.
---
## Data Storage
All shop and currency data is saved in your world folder under:
```
world/snurbos_shops/
shops.json — all player listings
currency.json — all player balances
settings.json — currency mode toggle
```
