Skip to content
Getting Started

Getting Started

Overview

XAuctionHouse is a full-featured auction house addon for XCore. It provides a server-wide marketplace where players can list items for fixed-price sale or start timed auctions with competitive bidding.

Key features

  • Dual listing modes — Fixed-price "Buy Now" listings and timed auctions with bidding
  • Multi-currency — Uses XCore's economy system; sellers choose which currency to list in
  • 11-category marketplace — All, Equipment, Blocks, Redstone, Resources, Food, Potions, Enchanting, Decoration, Spawners, Other
  • Advanced search — Filter by name, price range, material type, and listing type
  • Favorites system — Bookmark items for quick access
  • Bidding with snipe protection — Auctions automatically extend when bids arrive near the deadline
  • Smart delivery — Purchased items go to a claim queue if the buyer's inventory is full
  • Shulker box preview — View shulker contents before buying
  • Tax system — Configurable buyer-side or seller-side commission
  • Pending payments — Offline sellers receive their earnings when they next log in
  • Server listings (money sink) — Admin-created listings where the buyer pays but the proceeds are destroyed, taking currency out of the economy
  • Auction bans — Ban scammers from the auction house (temporary or permanent) with a configurable block scope
  • Discord webhooks — Notifications for sales, bids, auction wins, and admin actions
  • Web dashboard — Listings, sales history, statistics, player lookup, and a Bans management page
  • Cross-server sync — Listings, bids, and bans propagate instantly across a network
  • 8 GUI screens — Fully customizable via YAML files

Requirements

  • Paper 1.21.1+ (or Folia)
  • Java 21+
  • XCore 1.1+ installed as a plugin
  • PlaceholderAPI — Optional, for placeholders

Installation

  1. Install XCore in your server's plugins/ folder.
  2. Place XAuctionHouse.jar in plugins/XCore/addons/.
  3. Start the server. XAuctionHouse generates its config in plugins/XCore/addons/XAuctionHouse/.
  4. Edit config.yml and lang/<code>.yml to match your setup (currency, duration, taxes, blocked items, etc.).
  5. Restart or use /ah reload to apply changes.

XAuctionHouse relies on XCore's economy system. Make sure at least one currency is configured in XCore's config.yml before using the auction house.