# DonutSMP Plugin

**DonutSMP** is a lightweight, fully configurable economy and shop plugin for Minecraft Paper/Spigot 1.20+ servers, inspired by the popular Donut SMP economy system.

---

## Feature Highlights

- ** Full Economy System** — Persistent player balances stored in `economy.yml`, no database required.
- ** GUI Shop** — Beautiful 4-category shop menu (Combat, Food, Nether, End) with item previews and lore.
- ** /sell Command** — Instantly sell the item in your hand at configured prices.
- ** /pay Command** — Transfer money between players with notification messages.
- ** /balance Command** — Check your current balance (aliases: `/bal`, `/money`).
- **⚙️ Fully Configurable** — All prices, items, categories, shop titles, and messages editable in `config.yml`.
- ** Donut-Themed UI** — Clean dark GUI panes with colored category icons matching each shop section.
- ** Sell Multiplier** — Configurable sell multiplier (default 50%) applied to buy prices.

---

## Installation Instructions

1. Download `DonutSMP-1.0-SNAPSHOT.jar` from the `target/` folder.
2. Place the JAR file into your server's `plugins/` directory.
3. Restart your server.
4. Edit the generated `plugins/DonutSMP/config.yml` to customize prices and messages.
5. Run `/reload` to apply config changes without restarting.

**Requirements:** Paper or Spigot server running Minecraft 1.20+

---

## ⚙️ Configuration Guide

### Shop Categories & Items
Categories and items are defined under `shop.categories` in `config.yml`. Each item needs a `price` and `slot`.

```yaml
shop:
categories:
COMBAT:
title: "&0SHOP &8» &0COMBAT"
icon: DIAMOND_SWORD
items:
OBSIDIAN: { price: 10.0, slot: 10 }
END_CRYSTAL: { price: 50.0, slot: 11 }
```

### Custom Sell Prices
Override specific item sell prices under `sell.prices`:

```yaml
sell:
multiplier: 0.5 # 50% of buy price if no custom price
prices:
DIAMOND: 100.0
GOLD_INGOT: 25.0
```

### Messages
All messages use color codes (`&`) and support placeholders:

| Placeholder | Description |
|---|---|
| `%item%` | Item name |
| `%price%` | Transaction amount |
| `%balance%` | Player's current balance |
| `%player%` | Player name |
| `%amount%` | Item quantity |

---

## Commands

| Command | Aliases | Description |
|---|---|---|
| `/shop` | — | Opens the main shop GUI |
| `/sell` | — | Sells the held item |
| `/balance` | `/bal`, `/money` | Shows your balance |
| `/pay <player> <amount>` | — | Sends money to a player |

---

## ️ File Structure

```
plugins/DonutSMP/
├── config.yml # Shop items, prices, messages
└── economy.yml # Player balances (auto-generated)
```

---

## Additional Information

- **Version:** 1.0-SNAPSHOT
- **API Version:** 1.20
- **Author:** DonutStyle
- **Server Compatibility:** Paper 1.20+, Spigot 1.20+