🛒 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.
