Buying Selling and Bidding

Buying, Selling & Bidding

Everything is driven from the GUI. /ah opens the hub: Auction Browser, View Bids, and Manage Auctions.

Selling (creating a listing)

1. /ah → Create Auction (or /ah sell).
2. Deposit the item into the create screen.
3. Set a price by typing it in chat when prompted.
4. Pick a duration (from listings.durations).
5. Toggle the type — Buy-It-Now or Auction.
6. Confirm.

On confirm, the non-refundable listing fee (listings.fee) is taken from the seller immediately — the larger of the percentage and the minimum. The listing then appears in the browser under its category and tier, both computed at creation time.

A player can have up to listings.max-per-player active listings (default 7), raised per-rank with royalauctions.limit.<n>.

Buying (Buy-It-Now)

1. Browse or search, click a Buy-It-Now listing.
2. Confirm on the purchase screen (if confirmations.purchase is on).
3. The item is delivered:
   • With instant-deliver-purchases: true, it goes straight to your inventory when there's room, overflowing to the Collection only when full.
   • With it false, it always goes to the Collection to claim via /ah collect.

The seller is paid the price minus nothing further (the fee was already taken at listing time).

Bidding (Auctions)

1. Click an Auction listing → Place Bid.
2. Bid the minimum, or type a custom amount.
3. Confirm (if confirmations.bid is on).

Rules:

• Each bid must beat the current bid by at least the larger of bidding.min-increment (flat) and bidding.increment-percent (a fraction of the current bid).
• Your money is taken immediately and held while you're the top bidder.
• Outbid? You're refunded automatically, the moment someone beats you.
• When the auction ends, the highest bidder wins the item and the seller is paid the winning bid.

View Bids

/ah bids shows every auction you've bid on, and whether you're still the top bidder ("top bidder on X of Y"). This is powered by a per-bid record, so it stays accurate even after you've been outbid — see Storage & Data.

The Collection

/ah collect opens your Collection box — where won/bought items (when your inventory was full or instant-deliver is off) and returned items (from expired or cancelled listings) wait to be claimed. Nothing is ever destroyed by a full inventory; it lands here.

Managing your listings

/ah listings (or Manage Auctions) lists your active auctions. From here you can cancel a listing — which returns the item to your Collection. A listing that already has bids cannot be cancelled (that money is committed); it must run to the end.

Confirmations

Buy-It-Now and Create always had a confirm screen. Bids and cancellations now do too — both move real value on a single click (a bid holds your money until you're outbid or the auction ends, and the typed bid amount is exactly where you'd fat-finger an extra zero).

confirmations:
  bid: true
  cancel: true
  purchase: true

Turn any off for fewer clicks — the action then happens immediately with no screen rendered.