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

• ⚙️ Consistent Symbol Design
  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:

• Vault (Economy API)
• GriefPrevention
• GriefPrevention3D (Folia Supported)

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

---

🛡️ Permissions & Commands

---

🛠️ Setup

1. Install Vault 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 Paper / Spigot
• 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.