Compatibility
Minecraft: Java Edition
26.2
26.1.x
1.21.x
Platforms
Tags
Creators
Details
Licensed ARR
Published 10 hours ago
Updated 2 weeks ago
Auction House
A fast, GUI-based auction house plugin for buying, selling, and browsing items — just type /ah.
List an item from your hand, browse everyone else's listings in a paginated menu, search or filter by category, sort by price or age, check what you're currently selling, and look back through your full trade history. No signs, no chests to set up — it all runs from one command.
Supports Bukkit, Spigot, Paper, and Folia.
Features
- In-hand selling — hold an item and type
/ah sell <price>to list it. Price suffixes like5kand2.5mare supported. - Optional listing confirmation — a confirm screen shows the price, fee, and net payout before the item leaves your hand (togglable).
- Paginated browse menu — auto-refreshes every 60 seconds so sold or expired listings don't sit around.
- Sort — newest first, oldest first, cheapest first, or most expensive first.
- Filter by category — blocks, tools, weapons, armour, food, potions, books, or everything else.
- Search — search the whole auction house, or search just your own transaction history.
- View another player's listings —
/ah view <player>opens a filtered view of just their items. - Shulker box preview — right-click a listed shulker box to see what's inside before buying, without giving away the contents in the listing itself.
- My Items menu — see everything you currently have listed, cancel a listing to get the item back, and jump straight to your history.
- Transaction history — every purchase and sale is logged per player, with a running total of what you've spent and what you've made.
- Per-player listing limits — a default cap on active listings, liftable per-rank via permission nodes (see below).
- Configurable auction fee — take a percentage cut from every sale, or leave it at 0% so sellers keep the full price.
- Real-time expiry — listings expire after a set duration (default 7 days) in real time, whether or not the server was online the whole time.
- Safe offline returns — if a listing expires while the seller is offline, the item is held and handed back automatically on their next join.
- Blacklist — block specific materials from ever being listed.
- Fully customizable menus and messages — every menu layout, item, color, and message is editable via YAML, including hex colors.
- Multi-language support — separate language folders (English and German included) selected from the config.
- Flexible storage — choose between YAML (default, human-readable), SQLite, or MySQL (for sharing one auction house across multiple servers). Old data from Auction 1.x is migrated automatically.
- Vault economy support — hooks into any Vault-compatible economy plugin.
- PlaceholderAPI support — expose live auction data anywhere placeholders are supported (see below).
Commands
| Command | Description |
|---|---|
/ah |
Open the auction house |
/ah sell <price> |
List the item in your hand |
/ah search <text> |
Search all listings |
/ah view <player> |
View a specific player's listings |
/ah history [text] |
View (or search) your transaction history |
/ah mine |
View your own active listings |
/ah reload |
Reload the config and menus |
Aliases: /auction, /auctionhouse
Permissions
| Permission | Default | Description |
|---|---|---|
auction.use |
all players | Use the auction house |
auction.mute |
false | Hide "player listed an item" broadcasts for this player |
auction.reload |
op | Reload the config and menus |
auction.listings.<number> |
— | Raise this player's max active listings to <number> (only numbers above the configured default count; highest held node wins) |
PlaceholderAPI placeholders
Requires PlaceholderAPI and the auction expansion.
| Placeholder | Returns |
|---|---|
%auction_listings% |
Total number of active listings |
%auction_highest% |
Highest active listing price, formatted |
%auction_highest_raw% |
Highest active listing price, raw number |
%auction_lowest% |
Lowest active listing price, formatted |
%auction_lowest_raw% |
Lowest active listing price, raw number |
%auction_mine% |
How many listings the viewing player currently has |
%auction_mine_value% |
Total value of the viewing player's listings, formatted |
%auction_mine_value_raw% |
Total value of the viewing player's listings, raw number |
%auction_history% |
Number of transactions in the viewing player's history |
%auction_returns% |
Number of pending returns waiting for the viewing player |
Dependencies
- Vault (soft-depend) — required for any economy features to function
- PlaceholderAPI (soft-depend) — required only if you want the placeholders above


