MinepoursAh - Advanced Auction House Plugin

A powerful, feature-rich auction house plugin for Paper 1.21+ servers with Vault economy integration. Let your players buy and sell items in a beautiful GUI with advanced filtering, price history, and multi-item listing.

---

✨ Features

🏪 Core Auction System

• Beautiful GUI with customizable cyan-blue color scheme
• Multi-page browsing with intuitive navigation
• Buy & Sell items with Vault economy integration
• 24-hour listing expiration with automatic return system
• Offline sales - sellers receive money even when offline

🔍 Advanced Filtering

• 12 item categories (Weapons, Armor, Tools, Food, Blocks, Farming, Potions, Enchanted, Mob Drops, Misc, Other, All)
• Smart category detection - items automatically sorted to correct categories
• Quick category switching via hopper menu

📊 Price Analytics

• Weekly average prices displayed on item hover
• Sales statistics - total items sold and money spent
• Transaction history tracking

🛡️ Protection & Limits

• Price limits per item category - prevent junk items being sold for millions
• Listing limits per player - customizable via permissions (minepoursah.limiter.<number>)
• Anti-dupe protection - all GUI interactions secured
• Config validation - automatic recovery from corrupted configs

🎨 Quality of Life

• Sell GUI (/ah sellgui <price>) - list up to 5 items at once
• Right-click to remove your own listings instantly
• Expired items vault - reclaim unsold items after 24h
• Relist expired items with one click
• Sound effects for all actions
• Multi-language support (Russian & English included)
• Configurable GUI title and messages

👑 Admin Features

• Full plugin reload (/ah reload) with timing info
• Social media links command
• Configurable price limits per category
• Console logging for all reloads

---

📋 Commands

Command	Permission	Description
/ah	minepoursah.use	Open the auction house GUI
/ah sell <price>	minepoursah.sell	Sell the item in your main hand
/ah sellgui <price>	minepoursah.sell	Open GUI to sell up to 5 items at once
/ah help	minepoursah.use	Show help menu
/ah reload	minepoursah.admin	Fully reload config and language files
/ah social	minepoursah.admin	Display social media links

---

🔑 Permissions

Basic Permissions

Permission	Default	Description
minepoursah.use	true	Access to auction and help
minepoursah.sell	true	Ability to list items for sale

Listing Limits

Control how many items each group can list simultaneously:

Permission	Max Listings
minepoursah.limiter.3	3 listings
minepoursah.limiter.5	5 listings
minepoursah.limiter.10	10 listings
minepoursah.limiter.15	15 listings
minepoursah.limiter.20	20 listings
minepoursah.limiter.25	25 listings
minepoursah.limiter.50	50 listings
minepoursah.limiter.100	100 listings

💡 How it works: Players get the highest limit they have permission for. If a player has both minepoursah.limiter.5 and minepoursah.limiter.10, they can list up to 10 items.

Admin Permissions

Permission	Default	Description
minepoursah.admin	op	Access to reload and social commands

---

📦 LuckPerms Setup Examples

Default Player (3 listings)

/lp group default permission set minepoursah.use true /lp group default permission set minepoursah.sell true /lp group default permission set minepoursah.limiter.3 true

VIP Player (5 listings)

/lp group vip permission set minepoursah.use true /lp group vip permission set minepoursah.sell true /lp group vip permission set minepoursah.limiter.5 true

Premium Player (10 listings)

/lp group premium permission set minepoursah.use true /lp group premium permission set minepoursah.sell true /lp group premium permission set minepoursah.limiter.10 true

Admin (50 listings + admin commands)

/lp group admin permission set minepoursah.use true /lp group admin permission set minepoursah.sell true /lp group admin permission set minepoursah.admin true /lp group admin permission set minepoursah.limiter.50 true

---

⚙️ Configuration

All settings are stored in plugins/MinepoursAh/config.yml:

yaml language: "ru" auction: max-price: 10000000000 expiration-hours: 24 gui: title: "&b&lАукцион &9&lMP" confirm-title: "&bПодтверждение покупки" categories-title: "&bКатегории" my-listings-title: "&dМои лоты"

Language files are in plugins/MinepoursAh/lang/ - fully customizable (RU/EN included). Use /ah reload to apply changes without restarting.

---

🛡️ Price Limits System

The plugin automatically limits prices based on item value to prevent junk items from being sold for millions:

Category	Max Price	Examples
🗑️ Junk	25,000	Dirt, flowers, sticks, string, seeds
📦 Common	100,000	Most regular items, basic materials
💎 Valuable	500,000	Iron, gold, emeralds, golden apples
🔮 Epic	1,000,000	Diamonds, enchanted books, blaze rods
⭐ Legendary	5,000,000	Netherite, elytra, nether stars, beacons

If a player tries to list an item above its category limit, they will see a clear message showing the maximum allowed price for that item.

---

📊 Statistics Tracked

• Total items sold across the entire server
• Total money spent on all auction purchases
• Price history per item type with 7-day rolling average
• Sales counter per item material
• Stats persist through server restarts

---

🔧 Dependencies

Required: Paper 1.21+, Vault, Economy plugin (EssentialsX, CMI, etc.)

Optional: Essentials, LuckPerms (recommended)

---

📥 Installation

1. Download the latest .jar file and place in plugins/ folder
2. Ensure Vault and an economy plugin are installed
3. Restart server
4. Configure permissions with LuckPerms
5. Done! Players use /ah

---

🌐 Social Links

• Telegram
• WebSite
• Discord

---

❤️ Credits

Created with love by vesperade

---

📜 License

Распростронение расрешено, только с указанием источника и автора, :)