🛒 XShop - Premium GUI Shop Plugin

XShop is a state-of-the-art GUI-based shop system for Minecraft servers (Paper/Spigot 1.20+). It focuses on providing a clean, vanilla-style user experience while maintaining powerful administrative tools and logging.

---

🔥 Key Features

🕹️ User Interface & Experience

• Vanilla Aesthetics: High-performance GUIs without cluttered glass borders for a modern, clean look.
• Dynamic Category Menus: Supports unlimited categories with automatic multi-page navigation.
• Smart Purchase Selector:
  • Stackable Items: Interactive dye-based quantity controls (+1, +16, +64 / -1, -16, -64).
  • Non-Stackable Items: Simplified "Confirm/Cancel" flow for tools, armor, and totems.
• Inventory Safety: Advanced space validation prevents purchases if the player's inventory is full.

📜 Specialized Item Support

• Enchantments: Full support for custom-enchanted equipment (e.g., Sharpness V, Protection IV).
• Potions & Tipped Arrows: Advanced support for custom potion effects with accurate color-coded visuals (e.g., Slow Falling, Strength).
• Lore Formatting: Fully customizable display names and multi-line item lore.

🔗 Discord Webhook Logging

• Session-Based Batches: Reduces spam by sending a single, summarized report when a player closes the shop.
• Auto-Aggregation: Group identical purchases together (e.g., "10x Totem" instead of ten "1x Totem" entries).
• Admin Alerts: Sends a priority Red Alert if a player spends over a configured limit or buys suspicious quantities.
• Daily Summaries: Scheduled 24-hour reports detailing total revenue, transactions, and unique players.
• Failure Tracking: Logs when players attempt purchases with insufficient funds or full inventories.

⚙️ Backend & Performance

• SQLite Integration: Automatically migrates configuration data to a high-speed database for efficiency.
• Configurable Sound System: Audio feedback for every action (clicks, success, errors) for an immersive feel.
• Live Reload: Update your entire shop in real-time using /xshop reload.

---

🛠️ Commands & Permissions

Command	Description	Permission
/shop	Open the main shop categories menu	None (Default)
/xshop reload	Reload all configs, menus, and webhooks	xshop.admin

---

📂 Configuration Files

• config.yml: Main settings and First-level menu categories.
• webhook.yml: Discord settings, alert thresholds, and scheduler.
• sounds.yml: Audio sound-effect mapping.
• messages.yml: All player-facing text and colors.
• menus/: Folder containing individual category inventories (e.g., blocks.yml, food.yml).

---

🏗️ Requirements

• Server Platform: Paper or Spigot 1.20+
• Economy Dependency: Vault (with a provider like EssentialsX).
• Java: Version 17 or higher.