Getting Started

Requirements

  • Java 21 or higher
  • Paper 1.21.1+ (or Folia)
  • XCore (required — install it first)

Installation

  1. Make sure XCore is installed and running on your server.
  2. Download XAuctionHouse from BuiltByBit.
  3. Place the .jar file in /plugins/XCore/addons/.
  4. Restart your server — do not use /reload.
  5. XAuctionHouse will automatically connect to the database configured in XCore.
  6. Configure the plugin in /plugins/XCore/addons/XAuctionHouse/config.yml.

How Auctions Work

XAuctionHouse supports two listing types:

Fixed Price (Buy Now)

The seller sets a price, and any buyer can instantly purchase the item.

Timed Auction

  1. Seller runs /ah auction <starting_bid> with item in hand.
  2. Item appears in the auction house with an [AUCTION] tag.
  3. Buyers click the item to open the bid amount selector (+/- buttons).
  4. Each bid must exceed the current bid by the configured minimum increment.
  5. Outbid players are automatically refunded.
  6. Snipe protection: a bid placed near the end extends the auction duration.
  7. When the auction ends:
    • With bids: highest bidder gets the item, seller receives payment (minus tax).
    • No bids: item returned to seller or marked as expired.
Configuration