Описание
# 🧱 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 [duration]` | List item for sale | `azauctionhouse.use` |
| `/ah cancel [id]` | Cancel auction | `azauctionhouse.use` |
| `/ah return` | Retrieve expired items | `azauctionhouse.use` |
| `/ah search ` | 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 ` | Admin list auction | `azauctionhouse.admin` |
| `/ah blacklist ` | 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
```yaml
# &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!*