AzAuctionHouse

# 🧱 AzAuctionHouse **AzAuctionHouse** is a feature-rich auction house plugin that allows players to buy and sell items seamlessly on your Minecraft server. Built with performance and customization in mind. --- ## ✨ Features | Feature | Description | |---------|-------------| | 🏪 **Auction House GUI** | Intuitive interface for browsing and managing auctions | | 💰 **Multiple Economy Support** | Vault, PlayerPoints, TokenManager, CoinsEngine & more | | 🗄️ **Flexible Storage** | JSON, MySQL, SQLite, MongoDB support | | 🔍 **Smart Search & Filter** | Find items quickly with advanced filtering | | 📱 **Recommendation System** | AI-powered item suggestions for players | | 🛡️ **Anti-Dupe Protection** | Built-in security against item duplication | | 🔔 **Rich Notifications** | Action bar, chat, title, and sound notifications | | 🎨 **Custom Items Support** | ItemsAdder, Oraxen, MMOItems compatibility | | ⚡ **High Performance** | Optimized for large servers with Redis sync | | 🎯 **Permission System** | Flexible limits and group-based permissions | --- ## 📋 Commands & Permissions <details> <summary><strong>Click to expand command list</strong></summary> | Command | Description | Permission | |---------|-------------|------------| | `/ah` | Open auction house | `azauctionhouse.use` | | `/ah sell <price> ` | List item for sale | `azauctionhouse.use` | | `/ah cancel ` | Cancel auction | `azauctionhouse.use` | | `/ah return` | Retrieve expired items | `azauctionhouse.use` | | `/ah search <term>` | Search auctions | `azauctionhouse.use` | | `/ah history` | View transaction history | `azauctionhouse.use` | | `/ah recommend` | View recommendations | `azauctionhouse.use` | | `/ah clear` | Clear expired auctions | `azauctionhouse.admin` | | `/ah list <price> <count>` | Admin list auction | `azauctionhouse.admin` | | `/ah blacklist <add/remove>` | Manage blacklist | `azauctionhouse.admin` | | `/ah reload` | Reload configuration | `azauctionhouse.admin` | </details> <details> <summary><strong>Click to expand permission nodes</strong></summary> | Permission | Description | Default | |------------|-------------|---------| | `azauctionhouse.use` | Basic auction house access | `true` | | `azauctionhouse.admin` | Administrative commands | `op` | | `azauctionhouse.bypass.cooldown` | Bypass listing cooldown | `false` | | `azauctionhouse.bypass.blacklist` | Bypass item blacklist | `false` | </details> --- ## ⚙️ Requirements | Requirement | Version | |-------------|---------| | **Minecraft** | 1.8.8 - 1.21.7 | | **Java** | 8+ | | **Spigot/Paper** | Latest recommended | | **Vault** | Required for economy | ### Optional Dependencies - PlayerPoints, TokenManager, CoinsEngine (Economy) - ItemsAdder, Oraxen, MMOItems (Custom Items) - Redis (Multi-server sync) --- ## 📝 Configuration Example ```yaml # &6AzAuctionHouse Configuration prefix: "&7 " flatFee: 0.0 percentFee: 5.0 maxFee: 1000.0 minPrice: 1.0 maxPrice: 1000000.0 cooldown: 30 # Economy Settings economy: type: "Vault" format: "#,##0.00" symbol: "$" # GUI Settings gui: title: "&6Auction House" rows: 6 item-lore-format: - "&7Seller: &f%seller%" - "&7Price: &a%price%" - "&7Expires in: &f%time_left%" - "" - "&eClick to purchase!" # Storage Options storage: type: "JSON" # JSON, MySQL, SQLite, MongoDB # Recommendation System recommendation: enabled: true title: "&6&lRecommended For You" rows: 4 cacheDurationMinutes: 5 ``` --- ## 🎯 Quick Setup 1. **Download** AzAuctionHouse.jar 2. **Install** Vault and an economy plugin 3. **Place** jar in `/plugins/` folder 4. **Restart** your server 5. **Configure** `/plugins/AzAuctionHouse/config.yml` 6. **Enjoy** your new auction house! > ᴛɪᴘ: ᴜsᴇ `/ah help` ɪɴ-ɢᴀᴍᴇ ғᴏʀ ᴀ ᴄᴏᴍᴘʟᴇᴛᴇ ᴄᴏᴍᴍᴀɴᴅ ʟɪsᴛ --- ## 👨‍💻 Author & License **Author:** GamingHuzai **Discord:** gaminghuzai **Version:** 1.1 > Made with ❤️ by GamingHuzai **License:** All rights reserved © 2025 GamingHuzai --- *Thank you for choosing AzAuctionHouse for your server!*