ZephMC Docs

ZyAuctions

A player-driven auction house with buy-it-now listings, live bidding and a collection bin.

Players put items up for sale, other players buy or bid on them, and money changes hands through your existing economy plugin. Everything happens in one menu, opened with /ah.

What players can do

  • Sell at a fixed price. /ah sell 1200 puts whatever is in their hand up for 1200. The first person to click it takes it.
  • Run an auction. /ah auction 500 50 opens bidding at 500 with a minimum step of 50. Bids are held from the bidder's balance and refunded in full the moment they are outbid.
  • Browse, filter, search and sort. Ten categories, five sort orders, and a free-text search over item names.
  • Collect what is waiting for them. Anything that could not be handed over directly — an auction won while offline, a listing that expired, a purchase made with a full inventory — waits in their collection bin until they claim it.

What you control

Where nothing can go wrong

Two design rules are worth knowing about up front, because they explain behaviour you might otherwise find surprising:

An item is never in two places at once, and never in none. It is either in a player's inventory, attached to a live listing, or in a collection bin. Every path out of a listing puts the item somewhere before the listing disappears — including a server crash, because listings are written to storage as they change.

Withdrawn and expired items go to the collection bin, not straight into the inventory. That way the outcome is the same whether the player is online, offline, standing still or falling into the void with a full inventory.

A player whose collection bin is full cannot create new listings until they claim some items. That is deliberate: it is what guarantees an expiring listing always has somewhere to go. See collection.max-entries in Configuration.

On this page