GriefPrevention Shop

GriefPreventionShop

A clean, powerful, and fully configurable claim block shop addon for GriefPrevention built for performance, flexibility, and real server usage.

This plugin allows players to purchase claim blocks through a modern GUI, fully integrated with Vault-based economy systems.

---

✨ Features

* 🎨 Custom Aesthetic Designed with a unique visual style using Lime/Red Shulker Boxes and subtle elements like candles — no more generic menus.

* 👤 Dynamic Player Stats Real-time player head in GUI showing:

* Skin * Balance * Current claim blocks

* 📠 Discord Webhook Integration Send async purchase logs directly to Discord with player info and avatar.

* 📚 Claim History System Players can view their last 50 purchases using `/claimhistory` in a clean GUI.

* 🔊 Sound Feedback System Fully configurable sounds:

* Success → Level-up style feedback * Error → Clear failure indicators

* &e♯ Uses a unique &e♯ symbol across menus and messages for a polished feel.

* ⚡ Async Performance Engine Logging, Discord webhooks, and history are handled asynchronously to avoid TPS drops.

* 🧩 Fully Configurable

* GUI layout * Messages (chat/title/actionbar) * Prices * Sounds * Prefix & colors (HEX supported)

* 🎯 Custom Amount System Players can enter custom claim amounts via chat with timeout protection.

* 🧠 Smart Validation System Handles:

* Invalid input * Timeout * Insufficient balance * Missing dependencies

---

📦 Dependencies

This plugin requires:

* GriefPrevention (Economy API) * GriefPrevention

Make sure both are installed, otherwise the plugin will automatically disable itself.

---

🛡️ Permissions & Commands

| Command | Permission | Description | | :--------------- | :---------------------------- | :-------------------- | | `/gpshop` | `griefpreventionshop.use` | Open the claim shop | | `/claimhistory` | `griefpreventionshop.history` | View purchase history | | `/gpshop reload` | `griefpreventionshop.admin` | Reload all configs |

---

🛠️ Setup

1. Install GriefPrevention and GriefPrevention 2. Drop `GriefPreventionShop.jar` into `/plugins` 3. Configure `config.yml` (price, prefix, etc.) 4. (Optional) Add Discord webhook in config 5. Run `/gpshop reload`

You're ready to go.

---

📁 Configuration

* `config.yml` → Main settings (price, prefix, currency) * `messages.yml` → All messages (multi-format supported) * `shop-menu.yml` → GUI layout (fully customizable)

⚠️ The menu file is intentionally flexible — you can design it your own way.

---

📊 Logging System

* Stored inside: `/plugins/GriefPreventionShop/logs/`

* Includes:

* Player name * Amount purchased * Price * World * Timestamp

---

💬 Support

Need help or want to report something?

* Discord: https://discord.gg/Yxq6H8cb

---

⚠️ Notes

* Supports modern and older versions * Designed to work on both modern and older versions * Built with performance in mind (no main-thread blocking)

---

🚀 Final Words

This plugin is made for servers that want more than just a basic shop — clean UI, proper systems, and zero compromise on performance.