Modern Auction

🛒 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 |