Auction house

Players put an item up at a fixed price and anybody else buys it. The item leaves the seller's inventory when the listing goes up, lives in the database row while it is up, and leaves that row exactly once — sold, taken back or expired — so two buyers clicking the same listing on the same tick can never both get it. The loser of that race is refunded.

Module id auction-house, file modules/auction-house/config.yml, command /ah (also /auctionhouse).

Listing

Both end on the review screen, and nothing is charged or taken until Confirm:

• the item, the currency and how long the listing stays up;
• the whole price and the price per item, with a click to change it;
• the fee charged now, the tax taken on a sale, and You receive;
• your balance now and after the fee;
• a market price button, when the item has enough player sales: the 7-day average, last sale, median, trend and the suggested price for the whole stack. Clicking it sets the price.

A price far below the 7-day average asks once more before listing (prices.warn-below-percent). See Prices.

What is checked

In this order: an economy exists, the currency is one the server has, the item is not in blocked-materials, is not damaged unless allow-damaged-items, is not heavier than max-item-kilobytes, the price is within min-price and max-price, the player is under their listing limit, and they still carry the whole amount.

min-price and max-price are amounts of the default currency: a listing in another currency only has to be worth that currency's smallest amount, with no ceiling.

Fee and tax

A listing of 1,000 pays a fee of 20 when it goes up, and 950 to the seller when it sells.

Both can be set per rank with exyliamarket.auctionhouse.fee.<n> and exyliamarket.auctionhouse.tax.<n>, in whole percents, the lowest one held winning. The tax is read from the seller when the listing sells; a seller who is offline then pays the configured rate. See Permissions.

Buying

Buying needs exyliamarket.auctionhouse.buy. Left-click a listing to open its confirm screen: the price, your balance before and after, whether you can afford it and the time left. A price per item far above the 7-day average asks once more (prices.warn-above-percent). The money is taken first, then the listing is claimed; if somebody else got it first, the money goes straight back.

The item goes into your inventory, and whatever does not fit to /collect. The seller is paid at once and told on whichever server they are, or on their next join. You cannot buy your own listing unless allow-self-purchase is on; take it back instead.

Looking inside

A shulker box or bundle with something in it can be opened from the board, your listings or the confirm screen with a shift-click: a read-only view of what is inside, boxes within boxes included.

The board

Each listing shows its price, the price per item, the seller, the time left and, when the shop or the worth list buys it back, what one sells for to the server.

Sort, category and search are remembered until the player leaves.

Your listings, history and watchlist

/ah mine (also /ah listings) lists what you have up, how many against your limit and what they add up to per currency. Click one to take it back: the item comes back, the fee does not. From there:

• History — your latest purchases and sales, history-size of them.
• Watchlist — the listings you right-clicked that are still up. It is a bookmark list only: nothing notifies you about a watched listing.

Expiry

A listing stays up listing-hours (48 by default; 0 for never). Every minute a sweep sends what ran out back to its seller, through the same claim as a sale, so a listing being bought at that moment is not also returned. The seller is told it is on its way back.

Announcements

A sale at or above broadcast-above, and a new listing at or above broadcast-listed-above, are announced to the server. Both thresholds are in the default currency, so a listing in another currency is never announced. A seller's next listing is not announced again for broadcast-listed-cooldown-seconds. Players mute these in /settings under Market → Auction House; muting never hides their own sales.

Staff

/ahadmin (also /auctionhouseadmin) lists every listing, newest first. Left-click takes one down after a confirmation: the item goes back to the seller, who is told. Right-click opens its line in the market log.

Both ask for a confirmation first, need exyliamarket.auctionhouse.admin and must be run by a player in game.

Settings

Under settings: in modules/auction-house/config.yml, editable in game from /marketadmin.

And under sounds: — listed, bought, sold, cancelled — each written NAME|volume|pitch.