Auction house - Revision history

Admin: Fix mailbox cut % to match Fees (3%, verified in config)

2026-07-21T12:20:09Z

Fix mailbox cut % to match Fees (3%, verified in config)

← Older revision		Revision as of 12:20, 21 July 2026
Line 57:		Line 57:
	Run <code>/ah mailbox</code> to claim items that have come back to you: listings that expired with no buyer, or ones you cancelled. Click an item to collect it; if your inventory is full, it drops at your feet. Mailbox items '''never expire''', so nothing is lost by being offline.		Run <code>/ah mailbox</code> to claim items that have come back to you: listings that expired with no buyer, or ones you cancelled. Click an item to collect it; if your inventory is full, it drops at your feet. Mailbox items '''never expire''', so nothing is lost by being offline.

	Cash from a sale does not go to the mailbox. Sale proceeds — the sale price minus the 5% cut — are paid '''directly into your account balance''' the moment the item sells.		Cash from a sale does not go to the mailbox. Sale proceeds — the sale price minus the 3% cut — are paid '''directly into your account balance''' the moment the item sells.

	== Bedrock players ==		== Bedrock players ==

Maintenance script: 2026-06-10 staleness scan: tooltips retired, real AH fees, /trade status, PvP rules, CPI dual basket, eviction reclaim

2026-06-10T20:27:51Z

2026-06-10 staleness scan: tooltips retired, real AH fees, /trade status, PvP rules, CPI dual basket, eviction reclaim

← Older revision		Revision as of 20:27, 10 June 2026
Line 15:		Line 15:
	A listing fee is charged the moment you list, and a sale cut is taken when the item sells:		A listing fee is charged the moment you list, and a sale cut is taken when the item sells:

	* '''Listing fee:''' $5 plus 1% of the asking price, paid up front.		* '''Listing fee:''' $10 plus 1% of the asking price, paid up front.
	* '''Sale cut:''' 5% of the sale price, deducted from your proceeds at the time of sale.		* '''Sale cut:''' 3% of the sale price, deducted from your proceeds at the time of sale.

	The listing fee is '''not refunded''' if you cancel the listing or it expires. This deters listing spam, so set prices deliberately.		The listing fee is '''not refunded''' if you cancel the listing or it expires. This deters listing spam, so set prices deliberately.

VxMac: Create Auction house page (/ah fixed-price marketplace)

2026-05-29T22:05:56Z

Create Auction house page (/ah fixed-price marketplace)

New page

'''The auction house''' is a server-wide marketplace where players list items at a fixed price for any other player to buy. It complements [[ChestShop]] signs: ChestShop is best for high-volume commodity trading, while the auction house suits one-off, high-value, or hard-to-display items such as enchanted gear, named tools, and rare drops. Open it with <code>/ah</code>.

Despite the name, the auction house is not a bidding system. Each listing has a single fixed price set by the seller, and the first buyer to pay that price receives the item.

== Listing an item ==

# Hold the item stack you want to sell.
# Run <code>/ah sell <price> [hours]</code> — for example, <code>/ah sell 1500 24</code>.
# The stack moves into the marketplace and becomes visible to everyone in <code>/ah</code>.

The price is the total asking price for the whole held stack. The optional <code>hours</code> value sets how long the listing stays up before it expires; it defaults to 24 hours and can be at most 72 hours.

=== Fees ===

A listing fee is charged the moment you list, and a sale cut is taken when the item sells:

* '''Listing fee:''' $5 plus 1% of the asking price, paid up front.
* '''Sale cut:''' 5% of the sale price, deducted from your proceeds at the time of sale.

The listing fee is '''not refunded''' if you cancel the listing or it expires. This deters listing spam, so set prices deliberately.

=== Limits ===

{| class="wikitable"
|-
! Limit !! Value
|-
| Active listings per player || 5
|-
| Minimum price || $1
|-
| Maximum price || $10,000,000
|-
| Default duration || 24 hours
|-
| Maximum duration || 72 hours
|}

== Browsing and buying ==

* <code>/ah</code> or <code>/ah browse [page]</code> opens the marketplace, showing 45 listings per page, newest first.
* <code>/ah search <query></code> filters listings by item name.
* Hovering over a listing shows its full details: quantity, price, time remaining, seller, and any enchantments or custom lore.
* Clicking a listing buys it immediately. The cash leaves your balance and the item is delivered to your inventory, or dropped at your feet if your inventory is full. There is no separate confirmation step, so click carefully.

== Managing your listings ==

; /ah me
: Shows your active listings. Shift-click a listing to cancel it. The item returns to your [[#Mailbox|mailbox]], and the listing fee is not refunded.
; /ah cancel <id>
: Cancels a specific listing by its ID — the same action as shift-clicking in <code>/ah me</code>.
; /ah history
: Shows your last 50 settled listings, both sold and expired.

== Mailbox ==

Run <code>/ah mailbox</code> to claim items that have come back to you: listings that expired with no buyer, or ones you cancelled. Click an item to collect it; if your inventory is full, it drops at your feet. Mailbox items '''never expire''', so nothing is lost by being offline.

Cash from a sale does not go to the mailbox. Sale proceeds — the sale price minus the 5% cut — are paid '''directly into your account balance''' the moment the item sells.

== Bedrock players ==

The auction house works on [[Bedrock setup|Bedrock Edition]]. The browse and mailbox screens are standard chest menus that Geyser renders natively, and every command behaves the same as on Java.

== Trade safety ==

* Buying is instant and atomic: the cash and the item change hands together, so there is no risk of paying without receiving the item.
* Every sale is recorded in the server transaction ledger and feeds the [[Consumer Price Index]], so auction prices appear in <code>/market</code> data.
* High-value sales are logged for staff review.

== See also ==

* [[Trading]] — overview of every way to trade on the server
* [[Direct trading]] — private, secure item-and-cash swaps between two players
* [[ChestShop]] — player-owned shop signs for bulk commodities
* [[Item worth]] — how the worth engine estimates fair prices
* [[Commands]] — full command reference

[[Category:Gameplay]]