Commands

Opens the main auction house menu, and delivers any money payouts waiting for you on the way in.

The menu shows every active listing, newest first, 28 per page by default. See Auction house.

Shows only that player's active listings.

The name has to belong to somebody who currently has a listing up. If it does not match a seller, the argument is treated as a search term instead, so /ah diamond searches rather than failing.

Tab completion suggests the names of players who currently have listings.

Opens the auction house filtered to listings matching the query.

The match runs against the item's display name and against its material name with underscores turned into spaces, so diamond sword finds a Diamond Sword whether or not the seller renamed it.

This command works regardless of what SEARCH.METHOD is set to in config.yml. That setting only controls what the in-menu Search button does.

Searching with an empty query clears the filter.

With a price, the item in your main hand is taken into custody and a confirm screen opens. Without one, the sell menu opens instead and you are prompted for the price in chat.

AUCTION.COMPACT-PRICE-INPUT decides whether shorthand like 1.5k or 10m is accepted. It is off by default, so out of the box only plain numbers work.

The price has to sit between AUCTION.MIN-PRICE and AUCTION.MAX-PRICE, the item must not be blacklisted, and you must be under your listing slot allowance. Failing any of those returns the item to you with a message.

You can only have one sell in flight at a time. See Selling.

Opens your collection box and delivers any money payouts waiting for you.

The collection box holds items that could not be handed over: expired listings, cancelled listings, purchases that did not fit, and anything recovered from a server restart. See Collection box.

Opens your buy and sell history, newest first, up to the last 200 entries. Each entry shows whether you bought or sold, the price, the other player and the date.

/ah history is the same command.

Prints the command list. The admin commands are only shown to players holding atauctionhouse.admin.

The help text lives in your language file under COMMAND.HELP-HEADER, HELP-PLAYER, HELP-ADMIN and HELP-FOOTER, and {label} in it is whichever alias the player actually typed.

Re-reads config.yml, gui.yml and the language files.

Every open menu is closed first, and any item a player had handed to a menu is returned before anything is re-read. Cached listing limits and resolved sound names are cleared, so a permission change or a corrected sound name takes effect at once.

DATABASE.TYPE is deliberately not re-read. Changing the storage backend needs a full restart.

On a cross-server network with SYNC.CACHE-INVALIDATION on, a reload also asks every other server to rebuild its listing cache from the database.

Force-removes a listing by its numeric id. The item still goes back to its seller, or to their collection box if they are offline or full.

The id is the {id} placeholder, which you can put into a listing's lore in gui.yml. Tab completion suggests ids from the live listing cache.

Running it with no id prints the usage line. An id that does not exist, or a listing that is no longer active, prints a not-found message.

Prints the plugin version, the platform (Paper or Folia), the storage backend in use, whether cross-server mode is on, and how many active listings are currently cached.

This is the fastest way to confirm that a config change actually took effect.