DonutShop

# 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