AuctionX
Features
- GUI-driven auction house — browse, search, sort (newest/oldest/price) and page through listings without typing commands
- Fixed-price selling — list an item for a price, other players buy it directly; optional confirm dialog before every buy/sell (togglable per player)
- Per-rank limits — configurable max listings, listing duration and max price per permission-based rank; higher ranks can get better limits and (optionally) lower sales tax
- Sales & purchase history —
/ah soldand/ah boughtshow your last 10 transactions, with quick buttons to switch between the two - Offline earnings — sold while offline? Get paid automatically the next time you join
- Expired items tab — unsold listings move to an "Expired" tab instead of disappearing, so nothing gets lost
- Admin toolkit — reload config, browse/edit any player's listings, inspect or remove a specific listing by ID, wipe the whole auction house, maintenance mode, global sell-lock
- MySQL or SQLite — pick your storage backend, no external database required if you use SQLite
- Fully English & fully editable — every player-facing message lives in
messages.yml, not buried in code - PlaceholderAPI support — expose live listing counts, market value and per-player stats to your scoreboard/tab plugin
- Discord webhook — broadcast big sales to a Discord channel (configurable price threshold)
- Protection-plugin aware — the item-search sign respects WorldGuard, GriefPrevention, Towny and other protection plugins automatically, no extra setup needed
- Optional item blacklist — block spawners, command blocks and other classic auction-house exploit items (off by default)
- Optional sales tax — withhold a configurable % per rank on every sale as a money sink (off by default)
- Built-in update checker — get notified in-game and in console when a new version is available on Modrinth
- bStats metrics — anonymous usage statistics, standard for the Modrinth ecosystem
Commands
| Command | Description |
|---|---|
/ah |
Open the auction house |
/ah sell <price> |
List the item in your hand |
/ah search <item> |
Search active listings |
/ah show <player> |
View a player's listings |
/ah selling |
View your own listings |
/ah sold / /ah bought |
Your sales / purchase history |
/ah expired |
Collect your expired (unsold) items |
/ah settings |
Toggle sounds and (for admins) global switches |
/ah help |
Command overview |
/adminah reload |
Reload config.yml and messages.yml |
/adminah edit | menu <player> |
Browse/manage a player's listings |
/adminah info <id> |
Inspect a listing by its ID |
/adminah remove <id> |
Remove a listing by ID and return the item to the seller |
/adminah clear |
Wipe the entire auction house (with confirmation) |
/adminah update |
Manually check for a new version |
Permissions
| Permission | Default | Description |
|---|---|---|
actionhouse.use |
true |
Use the auction house |
ah.admin |
op |
Access to /adminah, bypasses price cap, tax and blacklist |
ah.special.vip / ah.special.ultra |
— | Example rank permissions, fully configurable in config.yml |
Requirements
- Vault
- Any Vault-compatible economy plugin (e.g. EssentialsX, CMI) — Vault itself doesn't hold balances, it just bridges to one
- Java 21, Spigot/Paper 1.21+
Configuration
config.yml— storage backend, rank limits, tax, blacklist, Discord webhook, update checker togglemessages.yml— every message the plugin sends, in English by default, fully editable with color codes (&)
