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, buy items directly, and manage their own listings. Sold items and expired listings are handled automatically, with configurable listing durations and fees.
The auction house uses the EssentialsC economy - balances are deducted on purchase and credited on sale. Listings persist across restarts.
Commands
| Command | Description |
|---|---|
/ah |
Open the auction house main GUI. |
/ah sell [price] |
Open the sell GUI from your inventory, or directly list the held item at a price. |
/ah cancel |
Open a GUI to cancel your active listings. |
/ah expired |
Open a GUI to collect items from expired listings. |
/ah listings [page] |
View all your active listings. |
/ah notifications |
Toggle sale notifications. |
/ah page <page> |
Open a specific page of the auction house. |
Configuration
Auction House settings live under the auction-house section in config.yml.
| Key | Type | Default | Description |
|---|---|---|---|
auction-house.max-listings |
Integer | 5 |
Maximum active listings a player can have at once. |
auction-house.duration-hours |
Integer | 72 |
How long a listing stays active before expiring. |
auction-house.min-price |
Double | 1.0 |
Minimum price for a listing. |
auction-house.max-price |
Double | 999999.99 |
Maximum price for a listing. |
auction-house.allow-enchanted-books |
Boolean | true |
Allow enchanted books to be listed. |
auction-house.blacklisted-materials |
List | [] |
Materials that cannot be listed. |
auction-house.notify-on-sale |
Boolean | true |
Notify sellers when their item is bought. |
Expired listings are kept for 30 days before being automatically purged. Players can collect expired items via
/ah expired at any time before the purge.
Permissions
| Permission | Description | Default |
|---|---|---|
essentialsc.auction |
Open and use the auction house. | Everyone |
essentialsc.auction.listing-bypass |
Ignore the max listings limit. | Operators |
essentialsc.auction.admin |
Manage any listing (remove, expire, cancel). | Operators |