Auction House

The auction house lets players create and buy listings from each other.

Opening the Auction House

• /auction (aliases: /ah, /auctionhouse)

• Or click the AUCTION HOUSE button in the shop UI

Browsing Listings

The main auction page shows all active listings in a grid. Use the controls to:

• Search: Filter listings by item name

• Sort: Newest, Oldest, Price Low to High, Price High to Low, Ending Soon

• Navigate: Use PREV/NEXT buttons for pagination

Click a listing to see its details: item info, price, seller, time remaining, and requested items (if any).

Creating a Listing

1. Click CREATE in the auction house.

2. Your inventory appears. Click the item you want to list.

3. Enter a price in the price field.

4. (Optional) Add requested items — items the buyer must provide alongside money.

5. Click CREATE to confirm.

A listing tax is deducted from your balance on creation (default: 5%).

Listing Limits

Each player has a maximum number of active listings (default: 3). Admins can grant higher limits with permission nodes:

taleshop.auction.5    → 5 active listings
taleshop.auction.10   → 10 active listings
taleshop.auction.50   → 50 active listings

The highest matching permission value is used.

Requested Items

Sellers can request specific items from buyers (up to 5 different items per listing by default). This allows item-for-item trading alongside money.

To disable this feature, set AllowPlayersAskForItem to false in config.

Buying a Listing

1. Click a listing to view details.

2. Click BUY.

3. Money is deducted and the item is delivered to your inventory.

4. If your inventory is full, the item goes to your mailbox instead.

Safety checks:

• You can't buy your own listings

• If payment fails, the transaction is rolled back

• If item delivery fails after payment, money is refunded

• Concurrent purchase attempts are handled (only one buyer succeeds)

Cancelling a Listing

Select your listing and click CANCEL. The item is sent to your mailbox.

Expiration

Listings expire after a configurable duration (default: 48 hours). Expired items are automatically sent to the seller's mailbox.

Background expiry checks run every 5 minutes.

Mailbox

The mailbox collects:

• Items from expired listings

• Items from cancelled listings

• Money from completed sales

Open the mailbox from the auction house by clicking MAILBOX.

Claiming

• CLAIM SELECTED: Claim a specific item

• CLAIM MONEY: Claim all pending money

• CLAIM ITEMS: Claim all items at once

Items are delivered to your inventory. If your inventory is full, the items stay in the mailbox until you have space.

Taxes

Tax on Creation (default)

A percentage of the listing price is deducted when you create a listing. If you don't have enough money for the tax, the listing is rejected.

{
  "AuctionListingTaxPercent": 5.0,
  "AuctionTaxOnSale": false
}

With a $100 listing and 5% tax: you pay $5 upfront. If the item sells, you receive $100.

Tax on Sale

Set AuctionTaxOnSale to true to collect tax when the item sells instead. No upfront cost, but the seller receives less when it sells.

With a $100 listing and 5% tax: no upfront cost. If the item sells, you receive $95.

Set AuctionListingTaxPercent to 0 to disable taxes entirely.

Configuration Reference

Option	Default	Description
AuctionHouseEnabled	true	Enable/disable the auction house
AuctionCommandEnabled	true	Enable/disable the /auction command
AuctionListingDurationHours	48	How long listings stay active
AuctionListingTaxPercent	5.0	Tax percentage (0 to disable)
AuctionTaxOnSale	false	Collect tax on sale instead of creation
AuctionListingMaxPrice	1000000000	Maximum listing price
DefaultAuctionLimit	3	Default max active listings per player
AuctionRequestItemLimit	5	Max different items requestable per listing
AllowPlayersAskForItem	true	Allow sellers to request items from buyers