Описание
# DonutShop
## ✨ Features
- **Multiple Shop Categories** – End, Nether, Gear, and Food shops with unique items
- **Economy Integration** – Seamless Vault integration for all transactions
- **Interactive GUI** – Beautiful unicode-styled shop interfaces
- **Fully Customizable** – Configure prices, messages, and sounds to your liking
- **Quantity Selection** – Players can adjust purchase amounts before buying
- **Sound Effects** – Audio feedback for successful and failed purchases
- **Hex Color Support** – Modern color codes for vibrant messages
## Commands & Permissions
| Command | Description | Permission | Default |
|-------------|--------------------------|----------------|---------------|
| `/shop` | Opens the main shop GUI | `donutshop.use` | All Players |
| `/donutshop` | Alias for `/shop` | `donutshop.use` | All Players |
## ⚙️ Requirements
| Component | Version |
|--------------------|--------------------------|
| **Minecraft** | 1.17+ (Full functionality) |
| **Java** | 8 or higher |
| **Spigot/Paper** | 1.13+ to 1.21+ |
| **Vault** | Latest version |
| **Economy Plugin**| EssentialsX, CMI, or similar |
> **⚠️ Note:** Servers running 1.13-1.16 may experience limited functionality due to missing materials from newer versions.
## ⚙️ Configuration
### Color Codes Reference
Use the `&` prefix for color codes in messages:
```
&0 Black &1 Dark Blue &2 Dark Green &3 Dark Aqua
&4 Dark Red &5 Dark Purple &6 Gold &7 Gray
&8 Dark Gray &9 Blue &a Green &b Aqua
&c Red &d Light Purple &e Yellow &f White
&l Bold &m Strikethrough &n Underline &o Italic
```
### Example Configuration (config.yml):
```yaml
# GUI Titles
gui:
main-shop-title: "ѕʜᴏᴘ"
end-shop-title: "ѕʜᴏᴘ - ᴇɴᴅ"
nether-shop-title: "ѕʜᴏᴘ - ɴᴇᴛʜᴇʀ"
gear-shop-title: "ѕʜᴏᴘ - ɢᴇᴀʀ"
food-shop-title: "ѕʜᴏᴘ - ꜰᴏᴏᴅ"
# Messages
messages:
not-enough-money: "&cYou don't have enough money."
inventory-full: "&cYour inventory is full."
# Sounds
sounds:
purchase-successful: "ENTITY_EXPERIENCE_ORB_PICKUP"
purchase-successful-volume: 0.5
purchase-unsuccessful: "ENTITY_VILLAGER_NO"
click: "UI_BUTTON_CLICK"
# Sample Prices
prices:
enderchest: 2500
blazerod: 150
totemofundying: 1250
steak: 35
```
## Shop Categories
**End Shop:** Ender Chest • Ender Pearls • End Stone • Dragon Breath • Chorus Fruit • Shulker Shells
**Nether Shop:** Blaze Rods • Nether Wart • Glowstone Dust • Magma Cream • Ghast Tears • Quartz
**⚔️ Gear Shop:** Obsidian • End Crystals • Respawn Anchors • Totems of Undying • Golden Apples • Arrows
**Food Shop:** Potatoes • Sweet Berries • Carrots • Apples • Cooked Chicken • Steak • Golden Carrots
## Installation
1. Download **DonutShop.jar**
2. Place it in your server’s **plugins** folder
3. Install **Vault** and an economy plugin
4. Restart your server
5. Customize **config.yml** to your preferences
6. Reload or restart to apply changes
## Version Info
**Current Version:** 1.8
**API Version:** 1.13+
**Author:** GamingHuzai
## Support
If you encounter issues, please ensure:
- You have the correct Minecraft version
- Vault and an economy plugin are installed
- Your configuration file uses valid YAML syntax
- All dependencies are up to date
© 2025 DonutShop Plugin - All rights reserved