🧱 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

Click to expand command list

Command	Description	Permission
/ah	Open auction house	azauctionhouse.use
/ah sell <price> [duration]	List item for sale	azauctionhouse.use
/ah cancel [id]	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

Click to expand permission nodes

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

---

⚙️ 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

# &6AzAuctionHouse Configuration
prefix: "&7[&6AzAuctionHouse&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!