🛒 ModernAuction — Advanced GUI Auction House & Listing Control System

ModernAuction is a modern, GUI-first auction plugin for Paper/Spigot 1.20+ servers (Folia-supported) that want more than a basic /ah.
It provides a polished auction house menu, secure buy/sell flow, listing fee + limit controls, smart search/filter tools, expired-item
reclaim, sold history, and shulker preview support — fully configurable via auction.yml.

Built for usability, safety, and full server-side control.

✨ GUI Auction Experience

Open a clean auction house with /ah or /auction
Browse active listings with paginated navigation
Buy instantly with left-click flow and clear result feedback

💰 Smart Selling & Economy Rules

List held item with /ah sell
Supports compact prices like 10k, 1.5m, etc.
Configurable listing fee percentage and max listing price
Configurable per-player max active listings

🔍 Search, Sort & Fast Browsing

Sign-based search input (/ah search support included)
Filter modes: Newest, Oldest, Cheapest, Pricest
Quick refresh + page navigation from GUI controls

📦 My Items Management

Dedicated “My Items” GUI with 3 states:
Active listings, Expired listings, Sold history
Reclaim active listings anytime
Reclaim expired items before auto-delete timer ends

🧱 Shulker Preview Support

Right-click preview for shulker listings
Read-only shulker content preview GUI
Bedrock-friendly click behavior included

🔔 Notifications & Lifecycle

ActionBar broadcast when new listing is posted
Seller sale notifications (with pending delivery on next join)
Automatic listing expiry and expired-storage cleanup

🎨 Fully Configurable in auction.yml

Messages, chat prefix, currency format, and time format
GUI titles, lore, buttons, search sign text
Listing limits, fee %, max price, blacklist, expiry timings

🔌 Dependency / Hook

Vault economy integration (required for buy/sell transactions)
Graceful message handling when economy provider is unavailable

🧾 Commands

Command	Description
/ah	Open auction house GUI
/auction	Alias of /ah
/ah sell	List main-hand item for sale
/ah search	Open auction with search filter
/ah reload	Reload auction config (admin)

🔐 Permissions

Permission	Description
aiols.ah.use	Open/use auction house
aiols.ah.sell	Create listings with /ah sell
aiols.ah.admin	Reload config with /ah reload
aiols.*	Grants all auction permissions