🛒 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 <price> 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 <item> 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 <price>	List main-hand item for sale
/ah search <item>	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