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:

Slot	Button	Function
45	Clock (Time Sort)	Toggle between Newest first and Oldest first
46	Hopper (Category Sort)	Cycle through categories: All, Tools, Weapons, Blocks, Armors, Spawners, Other, Favorites
47	Gold Ingot (Listing Type)	Filter: All Listings, Buy Now Only, or Auctions Only
48	Arrow (Previous Page)	Go to the previous page
49	Chest (My Items)	Open the My Items screen
50	Arrow (Next Page)	Go to the next page
51	Name Tag (Search)	Search by item name
52	Gold (Favorites)	View your bookmarked items

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

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.

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!"