# Auction House

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

## 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`)

```yaml
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](GUI-Customization.md) for moving/hiding the Auction House button and every menu element (including the "no listings" placeholder, which is fully positionable).

---

Next: [Crates](Crates.md)