Buying Items

Browsing the Auction House

Open the auction house with /ah. The main GUI shows all active listings in a paginated 54-slot inventory (45 item slots + bottom bar).

Sorting and filtering

The bottom bar provides several sorting and filtering options:

Each listing displays the item with lore showing the seller name, price (or current bid for auctions), expiration time, and an action button.

Buying Fixed-Price Items

To buy a fixed-price listing:

1. Click the item in the auction house GUI.
2. A confirmation screen appears showing the item details and price.
3. Click Confirm to complete the purchase, or Cancel to go back.

On purchase:

• The price is deducted from the buyer's account (in the listing's currency)
• If tax is enabled and set to BUYER, tax is added on top of the price
• The item is given to the buyer. If the inventory is full, it goes to the claim queue (accessible via /ah cancel > My Purchases)
• The seller receives payment (minus tax if type is SELLER). If the seller is offline, it goes to pending payments

Bidding on Auctions

Auction listings show a bid icon. Clicking opens the Bid Amount GUI where you select how much to bid:

1. Click an auction listing in the main GUI.
2. The Bid Amount Selector opens with preset increment buttons (e.g., +1, +10, +50) and a custom amount option.
3. Adjust your bid using the increment buttons. The bid must be at least the minimum increment above the current highest bid.
4. Click Confirm to place your bid.

Bid increment tiers

The increment buttons scale with the auction's starting bid. Each tier defines three buttons (small, medium, large):

bid-increments:
  - threshold: 100       # For auctions starting at 0-100
    values: [1, 10, 50]
  - threshold: 1000      # For auctions starting at 101-1000
    values: [10, 100, 500]
  - threshold: 10000     # For auctions starting at 1001-10000
    values: [100, 1000, 5000]
  - threshold: -1        # Fallback for anything above 10000
    values: [1000, 10000, 50000]

What happens when you bid

• Your bid amount is held immediately (deducted from your balance)
• The previous highest bidder is automatically refunded
• You cannot bid on your own auction
• You cannot bid if you are already the highest bidder

Buy it now

A seller can name a price the auction can be taken at immediately, and a buyer takes it with shift + right click on the listing.

/ah auction <starting bid> <duration> <currency> <buy-it-now price>

The standing bidder is refunded and the item changes hands. Order matters: the sale is claimed under the same lock as any other purchase first, and only once it is ours does anyone get money back — refunding before the claim would hand the bidder their money back on an auction somebody else went on to win.

auction:
  buyout:
    enabled: false

Snipe Protection

Snipe protection prevents last-second bids from stealing an auction. When a bid is placed within the threshold time of the auction ending, the auction is automatically extended.

snipe-protection:
  enabled: true
  threshold: 5m    # Triggers if bid placed within 5 minutes of end
  extension: 5m    # Extends the auction by 5 minutes

For example: if an auction ends at 3:00 PM and someone bids at 2:57 PM, the auction extends to 3:02 PM. If another bid comes at 3:00 PM, it extends again to 3:05 PM. This ensures all bidders have fair time to respond.

Advanced Search

The /ah search command supports filtering by multiple criteria simultaneously:

/ah search <query> [min_price] [max_price] [material]

Examples:

# Search for items named "diamond"
/ah search diamond

# Search for items named "sword" priced between 100 and 5000
/ah search sword 100 5000

# Search for diamond swords specifically
/ah search sword 0 999999 diamond_sword

You can also search from the GUI by clicking the Name Tag button (slot 51), which opens an anvil input where you type your search query.

To clear your search and return to the full listing, click the Remove Search button that appears while a search is active.

Alerts

A favourite tells you about an item you have already found. An alert tells you about one that is not listed yet: it stands until you remove it, and fires the moment somebody lists a match.

/ah alert add ELYTRA 50000
/ah alert list
/ah alert remove 3
/ah alert clear

The price is optional and acts as a ceiling — an alert on netherite at 20 000 stays quiet while the market sits above it. Alerts are checked as an item is listed, so the message arrives before anyone else has had a chance to browse.

Favorites System

Bookmark items you are interested in for quick access. The favorites system can be enabled or disabled in config.yml:

favorites:
  enabled: true

How to use favorites

• Add/remove: Shift + Right-click on any listing in the auction GUI, or use /ah favorite <item_uuid>
• View favorites: Click the Favorites button in the GUI, or use /ah favorites
• Favorited items show a gold star indicator in their lore
• If a favorited item is sold or expires, it is automatically removed from your favorites

Shulker Box Preview

When a shulker box is listed, buyers can preview its contents before purchasing:

• Left-click: Buy the shulker (or bid, if it is an auction)
• Right-click: Open the content viewer showing all items inside the shulker

The viewer is a read-only GUI that displays the shulker's contents exactly as they are stored.

Claiming Purchased Items

If your inventory is full when you buy an item, it goes to a claim queue. To claim pending items:

1. Open your items with /ah cancel (or click My Items in the GUI).
2. Switch to the My Purchases filter tab.
3. Click each item to claim it into your inventory.

On login, you receive a notification if you have unclaimed items: "You have X item(s) to claim!"