Selling Items

Fixed-Price Listing

The simplest way to sell: hold the item you want to list and use the /ah sell command. The item is removed from your hand and listed in the auction house at your chosen price.

/ah sell <price> [quantity] [currency]

Examples:

# Sell the entire stack in hand for 500 (default currency)
/ah sell 500

# Sell 16 of the held item for 200
/ah sell 200 16

# Sell the held item for 1000 gems
/ah sell 1000 gems

When a listing is created, the item is immediately removed from your inventory. If the listing fails (database error, validation failure), the item is returned automatically.

Auction Listing

Auctions let other players compete with bids. The highest bidder wins when the timer expires.

/ah auction <starting_bid> [duration] [currency]

Examples:

# Start an auction at 100, default duration (1d)
/ah auction 100

# Start a 3-day auction at 500
/ah auction 500 3d

# Start a 12-hour auction at 1000 gems
/ah auction 1000 12h gems

Duration supports these formats: s (seconds), m (minutes), h (hours), d (days), w (weeks). The duration must be between the configured minimum and maximum (default: 1h to 7d).

Server Listings (Money Sink)

Server listings are admin-created listings whose sale proceeds are destroyed instead of paid to a seller. The buyer is charged normally, but no one receives the money — so it leaves the economy entirely. This is ideal for a controlled server shop inside the auction house, or for fighting inflation.

Hold the item you want to sell and run:

/ah serverlist <price> [infinite] [currency]

Examples:

# A single server listing for 10000 (consumed when bought)
/ah serverlist 10000

# A restockable listing that can be bought repeatedly
/ah serverlist 10000 infinite

# An infinite listing priced in gems
/ah serverlist 500 infinite gems

• Server listings never expire and show a configurable Server seller name with a ★ Server listing tag.
• They are always fixed-price (no bidding) and ignore tax — the buyer pays exactly the listed price.
• They do not count against any player's sell limit.
• Remove one like any other listing: Shift + Left-click it in the GUI (requires ah.admin).

# config.yml
server-listings:
  enabled: true
  display-name: "Server"   # seller name shown for server listings

Item Categories

Every listed item is automatically assigned to one of 11 categories from its material:

Classification is an ordered list of rules rather than a chain of name matches, because order is the whole difficulty: nearly all of redstone is made of blocks, so it is asked about before the block rule; brewing ingredients are edible, so potions come before food.

Players browse by category using the sort button in the auction GUI. There is also a Favorites filter for bookmarked items.

Blocked Items

Admins can prevent specific items from being listed. Three blocklists are available in config.yml:

# Block by material type
blocked-materials:
  - ELYTRA
  - BEDROCK

# Block by display name substring (case-insensitive)
blocked-names:
  - fuck

# Block by anvil-renamed display name (case-insensitive)
blocked-anvil-names:
  - fuck

Shulker boxes are also checked: if any item inside a shulker matches the blocked materials or names, the entire shulker is rejected.

Restricted materials

The other direction: a material nobody may list unless they hold ah.sell.<material>. blocked-materials says "never"; restricted-materials says "not you" — a permission gate rather than a ban.

restricted-materials:
  - NETHERITE_INGOT
  - ELYTRA

A player with ah.sell.netherite_ingot may list netherite; everyone else is refused with a message. ah.sell.* covers the lot. Empty by default.

Sell Limits

You can restrict how many active listings a player can have simultaneously using the ah.limit.<amount> permission.

If a player has multiple ah.limit.* permissions, the highest value is used. If no limit permission is set, the default is 1 listing.

Auction listings have a separate cap configured via auction.max-active-auctions in config.yml (default: 5).

Listing Expiration

Listings automatically expire after the configured duration (default: 3d for fixed-price). When an item expires:

• It moves to the player's "Expired" tab in the My Items GUI
• The player receives a notification on their next login
• If auto-return-expired: true, expired items are automatically returned to the player's inventory on join

For auctions, the duration is set per-listing via the /ah auction command. If no bids were placed, the item is returned to the seller. If bids were placed, the highest bidder wins.

Abandoned listings

A player who never comes back never reclaims their expired listing, so it used to sit in memory and be reloaded at every start, for good. Two windows now clean that up, both in days, both disabled by setting them to 0:

purge:
  # The item goes back to its seller through XCore's mailbox, then the row is removed.
  expired-days: 30
  # How long a fully settled sale stays in the table as history.
  history-days: 90

Duplicate Listing Warning

When a player lists an item of the same material type they already have listed, they receive a yellow warning message. This is a soft warning only -- the listing is still created. It helps players avoid accidentally listing the same item type twice.