Auction House

#Information

The Auction House lets players sell items to each other. A listing either has a fixed price that anyone can pay right away, or it is an auction that goes to the highest bidder when time runs out.

Expired items, won auctions and anything that did not fit in an inventory go to the player's collection bin, so nothing is lost while a player is offline. Players who were offline when something happened get the messages the next time they join.

#Selling

Hold the item and open the sell menu with /ah sell. Pick the listing type, the price, how long it stays up and, when more than one is allowed, the currency. /ah sell <price> and /ah auction <starting bid> Premium list the held item straight away with the default duration.

The Price Guide Premium in the sell menu shows what the same item sold for over the last days: the average and the last price for one item, and how many sold. Clicking it sets the price to the average for the amount being sold. Custom items from item plugins are told apart from the vanilla item they are made of.

The listing fee is paid when the item is listed and is not refunded. The sales tax is taken from what the seller receives.

#Bundles Premium

/ah bundle <price> or /ah bundle <starting bid> auction opens a menu where the player puts up to 27 stacks that sell together as one listing. The buyer or winner gets every stack; players see the contents with Shift + Left-Click. Closing the menu without listing gives everything back.

#Buying and bidding

A fixed-price listing can be bought whole, or in part when partial buys are on. A bid Premium has to beat the current one by the minimum raise. The money is taken when the bid is placed and given back as soon as someone outbids the player or the auction is closed.

A bid in the last moments of an auction extends it, so nobody can win by bidding a second before the end.

A seller can cancel a listing until an auction has its first bid. Staff can remove any listing with Press Q: the item goes to the seller's collection bin and the highest bidder gets their money back.

#Watchlist and reminders Premium

Shift + Right-Click on a listing adds it to the player's watchlist, found in My Auctions. Watchers are told about new bids and when the listing ends.

The highest bidder and everyone watching are reminded shortly before a listing ends, by default five minutes and one minute before. Reminders only reach players who are online at the time; they are not saved for the next join.

#Listing again Premium

An expired item in the collection bin can go straight back up with Right-Click, at the same price and type, without taking it out first. The listing fee and limits apply again.

#Server Restock Premium

The server can put items up for sale on its own at a set interval, so the Auction House is never empty on a quiet server. Server listings carry the server's seller name, sit between the player listings and are bought like any fixed-price listing in the first auction currency; the money goes to nobody.

Each item has an amount, a price and how many listings of it go up per restock. After a restock where every listing of an item sold, its price rises by the price rise; when some were left over, it drops by the price drop, never past the item's lowest and highest price. A random variation can move it a little more each time. Changing an item's price starts it over from there.

Unsold server listings disappear at the next restock when Replace Unsold is on, otherwise when they end. Nothing goes to a collection bin, and staff removing one deletes it. Turning the restock on runs one straight away; a restart waits out the rest of the interval. Items are added from the one in your hand in Editor > Auction House > Features > Server Restock, which keeps custom items exactly as held.

#Categories

The categories in the menu come from auction-house.yml, in the order they are written; an item goes into the first one it matches, and into Other when it matches none. Changing them or adding your own Premium needs Premium.

categories:
  crate-keys:
    enabled: true
    name: Crate Keys
    icon: TRIPWIRE_HOOK
    data-keys:
    - phoenixcrates:key
  blocks:
    enabled: true
    name: Blocks
    icon: GRASS_BLOCK
    types:
    - BLOCKS

Set enabled: false to hide a category.

#Settings

The command and its aliases are set with the other commands, under auction-house.

The tax is fixed when an item is listed, so a permission change later does not change what an existing listing pays. The blacklist and allow-list also apply to the contents of shulker boxes and bundles. Every message is in the translation file, under the auction-house section.

#Menus

Every menu can be laid out in game from Editor > Auction House > Menus, or changed in its file inside menus/auction-house: main.yml, sell.yml, bundle.yml Premium, listings.yml, watchlist.yml Premium, collection.yml, history.yml, preview.yml and one confirm menu per action, confirm-buy.yml, confirm-bid.yml Premium, confirm-cancel.yml and confirm-remove.yml.

Bedrock players type prices, amounts, bids and searches in a form, and pick Shift and Press Q actions from a list. Java players get a dialog on Paper servers that support dialogs, and type in chat everywhere else.

#Discord

Listings, sales, bids, expired and removed listings and server restocks can be posted to Discord with the Premium edition, like the other Discord Webhooks.

#Moving from another auction plugin

Editor > Migrations brings live listings, auctions, expired items and money still owed across from zAuctionHouse, PlayerAuctions, CrazyAuctions and Auction House (Kiranhart). Bids come across only when the old plugin took the bidder's money at bid time; otherwise the auction restarts at its price. Running it again skips what already came across. Remove the old plugin afterwards, since its files still hold everything.

#Placeholders

#Files

#Commands

#Permissions