Auction house
A network wide auction house where players sell items at a fixed price or through bids, with categories, search, fees and taxes.
The auction house lets your players sell items to each other. Listings are shared by every server of your network, so an item put on sale in the lobby can be bought from survival. Players sell at a fixed price or start an auction with bids, and you control prices, fees, taxes and which items are allowed.
The auction house needs the economy module. If economy is disabled, the auction house stays closed and the web editor tells you so.
Features
- Fixed price or auction. A fixed price listing is bought instantly. An auction runs until its end and the highest bidder wins.
- Browse menu. Players open
/ahto see live listings, 45 per page, with buttons to filter by category, sort, search, filter by seller, see their own listings, see their history and sell an item. - Categories: Blocks, Tools, Weapons, Armor, Food, Potions, Enchanted books and Miscellaneous. Items are sorted into them automatically.
- Sorting: newest, cheapest or ending soon.
- Search in any language. Item names are searchable in English, French, Spanish and German, whatever the language of the player searching.
- Selling from a menu. Players pick an item from a copy of their inventory, type the price in chat, then choose between fixed price and auction. The confirmation shows the price, the listing fee, the tax on the sale and the listing duration.
- Safe bids. The money of a bid is held as soon as it is placed. When someone bids more, the previous bidder is refunded. Sellers cannot bid on their own listing, and a player cannot outbid themselves.
- Last second protection. A bid placed in the final moments extends the auction, so nobody can snipe it.
- Everything goes through the mailbox. Bought items, won items, money from sales, refunds and items that did not sell are delivered through the mailbox. Players get them even if they were offline or on another server.
- Cancel a listing. Sellers can cancel a listing as long as it has no bid. The item comes back through the mailbox.
- Protected items. Menu icons, staff tools and other special items from InglisCore can never be sold. Shulker boxes are checked too: a shulker containing a forbidden item is refused.
- Staff moderation. Staff with
inglis.auction.admincan remove any listing in game. You can also remove listings from the web editor. The item goes back to the seller and the highest bid is refunded. - Statistics. The web editor shows sales, volume, average sale, taxes collected, best selling items, top sellers and sales per day, over the period you choose.
- Player profiles. Each player profile in the web editor shows their live listings, sales, purchases and recent auction activity.
Setting it up
Open Auction house in the web editor. The page has four views: Live listings, Statistics, Forbidden items and Command, plus the module settings.
General
| Setting | What it does | Default |
|---|---|---|
| Currency | Currency used for prices. Leave empty to use the main currency. | Main currency |
| Minimum price | Lowest price or starting price allowed for a listing. | 1 |
| Maximum price | Highest price or starting price allowed for a listing. | 1,000,000,000 |
| Refuse sales in creative mode | Players in creative mode cannot list items. | On |
| History kept (days) | Ended listings older than this are deleted from the history and the statistics. | 60 |
Fees and taxes
| Setting | What it does | Default |
|---|---|---|
| Listing fee type | Percent of the price or Fixed amount. | Percent of the price |
| Listing fee | Paid when an item is listed, never refunded. 0 for free listings. | 1 |
| Tax on sales (%) | Taken from what the seller receives on each sale. | 5 |
Auctions with bids
| Setting | What it does | Default |
|---|---|---|
| Enable auctions | Players can start auctions and bid. When off, only fixed price listings are possible. | On |
| Bid step type | Percent of the highest bid or Fixed amount. | Percent of the highest bid |
| Minimum bid step | How much more than the highest bid a new bid must be. | 5 |
| Last second window | A bid placed this close to the end extends the auction. 0 to disable. | 1 minute |
| Extension | Time left after a last second bid. | 2 minutes |
Items
| Setting | What it does | Default |
|---|---|---|
| Forbidden description texts | Items whose description contains one of these texts cannot be sold. | Empty |
| Forbidden item tags | Tags of special items from other plugins (plugin:key, or key alone) that cannot be sold. |
Empty |
| Allow crate keys | Crate keys can be sold. Menu icons and staff tools never can. | On |
The Forbidden items view lists the item types that can never be listed. It comes with bedrock, barriers, command blocks, structure blocks, spawners, debug sticks and other admin items already in it. Use Add an item to forbid more.
Listings and duration per rank
How many listings a player can have live at once and how long a listing lasts are set per rank in the Command view:
| Limit | Everyone | vip rank |
mvp rank |
|---|---|---|---|
| Live listings at most | 10 | 20 | 30 |
| Listing duration (hours) | 48 | 72 | 96 |
Change these values or add rules for your own ranks. The rank rules only apply if those ranks exist on your server.
Commands
| Command | What it does | Permission |
|---|---|---|
/ah |
Opens the auction house. | inglis.auction.ah (everyone) |
/ah sell |
Opens the menu to pick an item to sell. | inglis.auction.ah |
/ah sell <price> [amount] |
Lists the item in your hand at a fixed price. | inglis.auction.ah |
/ah auction <price> [amount] |
Starts an auction with the item in your hand, from this starting price. | inglis.auction.ah |
/ah mine |
Shows your live listings. | inglis.auction.ah |
/ah history |
Shows your ended listings and purchases. | inglis.auction.ah |
/ah search <text> |
Opens the auction house filtered on a search. | inglis.auction.ah |
/auction and /auctionhouse are aliases of /ah. The alias, permission, cooldown, price, worlds and rank rules of /ah can be changed in the web editor, see commands.
Permissions
| Permission | What it grants |
|---|---|
inglis.auction.ah |
Use the auction house. Given to everyone by default. |
inglis.auction.admin |
Remove any listing in game with a shift right click on it in the browse menu. |
Tips
- In the menus, players type prices, bids and searches in chat. Typing the cancel word shown in chat, or waiting one minute, cancels the prompt.
- A listing fee in percent discourages players from flooding the auction house with overpriced items, since the fee is never refunded.
- If you use items from other plugins that must stay out of the economy (soulbound items, event rewards), add their tag or a text from their description in Items.