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 sold and /ah bought show 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 toggle
• messages.yml — every message the plugin sends, in English by default, fully editable with color codes (&)