━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✨ Feature Overview
Core
- Full GUI System — Browse, buy, sell, and manage listings through intuitive menus
- Buy & Sell Confirmation — Review every transaction before committing
- Mailbox System — Expired and purchased items delivered safely — zero item loss guarantee
- Container Preview — Preview shulker box and bundle contents before buying
Discovery
- Category Browser — 10 item categories with visual icons
- Advanced Filters — Filter by category, price range, seller, and keyword search
- Price History Charts — Visual sale price history per item type
- Seller Profiles — View seller stats, active listings, and online status
Economy
- Listing Fees & Sales Tax — Configurable flat fee, percentage fee, and sales tax
- Vault & More — Vault, PlayerPoints, EssentialsX, and XP economy support
- LuckPerms Integration — Per-group listing limits, expiry times, and fees
Server Administration
- Anti-Exploit Protection — Atomic SQL transactions, transaction locking, anti-dupe safeguards
- Multi-Database — SQLite (default), MySQL, and MariaDB fully supported
- Migration Tools — Import from CrazyAuctions, zAuctionHouse, Fadah, and Akarian
- Fully Configurable — Every message, GUI layout, icon, and feature is customizable
- Discord Webhooks — Notifications for new listings and sales
- PlaceholderAPI — Built-in placeholders for scoreboards and tab lists
- WorldGuard — Restrict auction access by region
- Folia Compatible — Async-safe with entity-thread scheduling
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⌨️ Commands
Player Commands
Code (Text):
/ah — Open the auction house
/ah sell <price> [amt] — List the item in your hand
/ah search <keyword> — Search listings by name
/ah cancel <id> — Cancel your listing
/ah active — View your active listings
/ah claim — Claim all mailbox items
/ah help — Show all commands
Admin Commands
Code (Text):
/ah admin reload — Reload config and messages
/ah admin forcecancel <id> — Remove any listing
/ah admin return <player> — Return items to a player
/ah admin stats — Server-wide market statistics
/ah admin lookup <id> — Inspect a listing
/ah admin transactions [player] — View transaction log
/ah admin purge <days> — Clear old records
/ah admin import — Import from other plugins
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Permissions
Code (Text):
auction.use — Access the auction house (default: true)
auction.sell — List items for sale (default: true)
auction.buy — Purchase items (default: true)
auction.cancel — Cancel own listings (default: true)
auction.admin — Access admin commands (default: op)
auction.admin.reload — Reload configuration (default: op)
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Installation
- Drop AuctionHouse.jar into your plugins/ folder
- Restart your server
- Edit plugins/AuctionHouse/config.yml to your liking
- Run /ah admin reload or restart — done!
️ Database Setup
SQLite works out of the box — zero configuration needed. For MySQL or MariaDB:
Code (Text):
storage:
type: mysql
mysql:
host: localhost
port: 3306
database: auctionhouse
username: your_user
password: your_pass
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Dependencies
- Required: Paper 1.20+ (or any Paper fork)
- Required: Vault + an economy plugin (EssentialsX, CMI, etc.)
- Optional: LuckPerms, PlaceholderAPI, WorldGuard
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Support
Found a bug or have a suggestion? Join our
Discord or leave a message in the discussion tab.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Pro Edition — Coming Soon
A premium edition with advanced features is in development:
- Buy Orders & Order Book Matching Engine
- Admin Dashboard GUI with live stats
- Silent & Blind Auctions
- Marketplace Tags & Item Tagging
- Scheduled Auctions
- Bulk Listings & Partial Buying
- CSV Data Export
- Content Moderation Tools
- And more...
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Made with care. Built for performance. Designed for players.