Auction House

Auction House

A full player-to-player marketplace for cosmetics, priced in your server's own currency (see Economy Integration).

For Players

Open it via the button on the main menu, or /cosmetics ah.

Selling:

1. Open your vault, click a cosmetic you own a real copy of.
2. Click AUCTION.
3. Type a price in chat (or cancel to abort).
4. The copy is removed from your vault and the listing appears for everyone.

You can also sell directly: /cosmetics sell <type> <id> <price>.

Buying:

1. Browse the paginated listings.
2. Click a listing — if it's not yours, a confirmation menu opens showing the price.
3. Confirm to buy. The item is added to your vault immediately.

Cancelling your own listing: click it in the browse menu (your own listings are visually highlighted) to instantly cancel and get the copy back into your vault.

Guarantees

• Atomic purchases. The listing removal from the database is the single point of truth — if two players try to buy the same listing at the same instant, only one succeeds. The other is told the listing is no longer available; no currency is ever charged for a failed purchase.
• Offline-safe payouts. Sellers get paid even if they log off between listing and sale.
• Tax. A configurable percentage is deducted from the seller's payout, not added to the buyer's price.

Configuration (config.yml)

auction:
  currency: "credits"
  currency-display: "Credits"
  economy-mode: "api"          # api | commands — see Economy Integration
  balance-placeholder: "%eddungeons_currency_balance_credits%"
  commands:
    give: "{currency} give {player} {amount}"
    take: "{currency} remove {player} {amount}"
  min-price: 1
  max-price: 1000000000
  tax-percent: 5
  menu:
    slot: 22
    title: "&8Auction House"
    confirm-title: "&8Confirm purchase"
    empty:
      material: GRAY_DYE
      name: "&7No listings yet"

See GUI Customization for moving/hiding the Auction House button and every menu element (including the "no listings" placeholder, which is fully positionable).

---

Next: Crates