DonutAuctionHouse is the server's player-run marketplace where you can buy, sell, and auction items safely without needing to meet face-to-face. Everything runs under the /ah command (with aliases /auction and /auctionhouse).

Players can browse listings, filter by category, search by name or enchantment, buy instantly, or place competitive bids on live auctions.

Player Commands

Command What it does Permission
/ah Open the auction house menu donutauction.use
/ah sell <price> [auction] List the item in your hand (1k, 2.5m, 1b shortcuts work) donutauction.sell
/ah auction <starting bid> Start an auction with bidding donutauction.sell.auction
/ah search <text> Search items by name, lore, enchantment, or seller donutauction.use
/ah view <player> (/ah <player>) View listings put up by a specific player donutauction.use
/ah price Check recent market prices for the item in your hand donutauction.use
/ah collect (/ah cancel) Open your collection box (expired/cancelled items) donutauction.use
/ah history [sold] View your past purchases and sales donutauction.use
/ah limit Check your current active listing limit donutauction.use
/ah fastbuy Toggle skipping the purchase confirmation click donutauction.fastbuy
/ah fastsell Toggle listing without opening the sell menu donutauction.fastsell
/ah help Show the player command list donutauction.use

Selling and Auctions

  1. Buy It Now (Sell): Hold the item you want to sell in your main hand and run /ah sell <price>. For example, /ah sell 50k. You can use shorthands like 1k, 2.5m, or 1b.
  2. Auctions: Run /ah auction <starting bid> to put an item up for bidding. Bids are escrowed immediately, and outbid players receive instant refunds so money is never lost.
  3. Fees and Taxes: A small listing fee or sales tax may apply depending on server configuration, keeping the economy balanced and preventing spam listings.

Collection and Safety

Never worry about losing items. When an auction expires or you cancel a listing, your items go straight into your collection box. Run /ah collect at any time to claim them back. Transactions and item data are securely handled, preventing duplication bugs or item loss.

Staff Commands

Operators and administrators can manage the market using /ah admin commands (donutauction.admin permission required):

Command What it does
/ah open <player> [...] Open a specific menu view for a player (useful for console, NPCs, or menu plugins)
/ah admin view <player> Inspect a player's active listings and click to remove them
/ah admin remove <id> Force-remove a specific listing by its ID
/ah admin info Check storage stats, active listings, and database health
/ah admin purge <days> Delete settled transaction history older than the specified days
/ah reload Reload config.yml and messages.yml from disk without restarting

Integrations and Placeholders

With PlaceholderAPI installed, DonutAuctionHouse registers %donutauction% placeholders for scoreboards, holograms, and tab lists.

Source and documentation reference: Nightbeam Docs