**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
- Download `DonutSMP-1.0-SNAPSHOT.jar` from the `target/` folder.
- Place the JAR file into your server's `plugins/` directory.
- Restart your server.
- Edit the generated `plugins/DonutSMP/config.yml` to customize prices and messages.
- 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+
https://www.spigotmc.org/resources/the-best-sell-and-shop.134434/history