Configuration

# Listing duration before expiration
duration: 3d

# Maximum price
maximum-price: 1000000000

# Default currency (empty = vault primary from XCore)
default-currency: ""

# Blocked items
blocked-materials: [ELYTRA]
blocked-names: [fuck]
blocked-anvil-names: [fuck]

# Auto-return expired items on join
auto-return-expired: false

# Sale announcements
announce-sale: true
announce-type: BOSSBAR    # CHAT, ACTION_BAR, TITLE, SUBTITLE, BOSSBAR

# Tax on sales
tax:
  enabled: false
  rate: 0.05          # 5%
  type: SELLER        # SELLER or BUYER

Tax can be applied to either the seller (deducted from earnings) or the buyer (added to purchase price). Configure the rate as a decimal (0.05 = 5%).

# Auction system
auction:
  enabled: true
  default-duration: 1d
  min-duration: 1h
  max-duration: 7d
  min-starting-bid: 1

  # Bid increment — flat amount or percentage (percentage takes priority if > 0)
  min-bid-increment: 1.0
  min-bid-increment-percent: 0

  # Maximum active auctions per player
  max-active-auctions: 5

  # Snipe protection — extends auction if bid placed near the end
  snipe-protection:
    enabled: true
    threshold: 5m
    extension: 5m

  # Announcements
  announce-bids: false
  announce-wins: true

Duration format: 1h, 6h, 12h, 1d, 3d, 7d. Must be between min-duration and max-duration.

XAuctionHouse uses XCore's multi-currency economy system. Any currency defined in XCore is automatically available for listings and purchases. If no currency is specified in commands, the primary Vault currency from XCore (the one with vault: true) is used.

Prices are displayed with the correct currency symbol everywhere in GUIs and messages.

# Favorites system
favorites:
  enabled: true

Players can bookmark items and access them from a dedicated favorites view. Obsolete favorites (expired/sold items) are automatically purged.

# Discord webhooks — separate channels for sales and admin actions
discord-sales:
  enabled: false
  webhook-url: ""

discord-admin:
  enabled: false
  webhook-url: ""

Notifications are sent for listings, sales, bids, auction wins, and admin actions.