Auction House
A fully-featured GUI-based auction house for player-to-player item trading.
Overview
The Auction House lets players list items for sale at a fixed price. Other players can browse active listings in a GUI, search them by item name or material, buy items through a confirmation screen, and manage their own listings. Sold items and expired listings are handled automatically, with configurable listing durations and limits.
The auction house uses the EssentialsC economy - balances are deducted on purchase and credited on sale. Listings persist across restarts. Shulker boxes show their contents in a preview GUI before buying, the main GUI links to your buy and sell history, and a purchase is rejected when the item does not fit in the buyer's inventory.
Commands
| Command | Description |
|---|---|
/ah |
Open the auction house main GUI. |
/ah sell <price> |
List the item in your main hand. Price accepts k, m, b, and t multipliers. |
/ah cancel <id> |
Cancel one of your active listings by ID. |
/ah expired |
Open a GUI to collect items from expired listings. |
/ah listings |
View all your active listings. |
/ah search <query> |
Search listings by item name or material name (alias /ah find). |
/ah notifications |
Toggle sale notifications. |
/ah <page> |
Open a specific page of the auction house. A non-numeric argument is treated as a search query. |
/ah reload |
Reload the Auction House configuration (alias /ah rl). |
/ah help |
Show the Auction House command usage. |
Configuration
Auction House settings live under the auction-house section in config.yml.
| Key | Type | Default | Description |
|---|---|---|---|
auction-house.enabled |
Boolean | true |
Disable the auction house and unregister /ah. |
auction-house.max-auctions-per-player |
Integer | 5 |
Maximum active listings a player can have at once. Overridden by essentialsc.ah.listings.<n>. |
auction-house.duration-hours |
Integer | 48 |
How long a listing stays active before expiring. |
auction-house.min-price |
Double | 1.00 |
Minimum price for a listing. |
auction-house.max-price |
Double | 5000000 |
Maximum price for a listing. |
auction-house.allow-enchanted-books |
Boolean | false |
Allow enchanted books to be listed. |
auction-house.blacklisted-materials |
List | DRAGON_EGG, BEACON, NETHER_STAR |
Materials that cannot be listed. |
auction-house.blacklisted-custom-items |
List | empty | Custom items that cannot be listed, matched by material, display name, and/or custom-model-data. |
auction-house.notify-on-sale |
Boolean | true |
Notify sellers when their item is bought. |
auction-house.confirmation-gui |
Boolean | true |
Show a confirmation GUI before purchasing an auction. |
/ah expired. The number of active listings a player may have is raised by granting essentialsc.ah.listings.<n> - the highest number found is used.
Permissions
| Permission | Description | Default |
|---|---|---|
essentialsc.ah.use |
Access the Auction House. | Everyone |
essentialsc.ah.sell |
Sell items in the Auction House. | Everyone |
essentialsc.ah.buy |
Buy items from the Auction House. | Everyone |
essentialsc.ah.cancel |
Cancel your own auctions. | Everyone |
essentialsc.ah.notifications |
Toggle sale notifications with /ah notifications. |
Everyone |
essentialsc.ah.listings.<n> |
Raise the active listing limit (available: 1, 2, 3, 5, 10, 15, 20, 25, 50). | Nobody |
essentialsc.ah.admin |
Cancel any auction and full admin control. | Operators |
essentialsc.ah.bypass.limit |
Bypass the max auctions per player limit. | Operators |
essentialsc.ah.bypass.blacklist |
Bypass the blacklisted items restriction. | Operators |
essentialsc.ah.bypass.price.min |
Bypass the minimum price restriction. | Operators |
essentialsc.ah.bypass.price.max |
Bypass the maximum price restriction. | Operators |
essentialsc.ah.expired.others |
Claim expired items belonging to other players. | Operators |
essentialsc.ah.reload |
Reload the Auction House configuration. | Operators |