XShop

# 🛒 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:** (https://www.spigotmc.org/resources/vault.3431/) (with a provider like EssentialsX). - **Java:** Version 17 or higher.