How to Set Up Auction House on Your Minecraft Server

What Is an Auction House Plugin?

An Auction House plugin adds a global marketplace where players can list items for sale without needing a physical shop location. Instead of building a ChestShop stall somewhere in the world, a player types /ah sell 500 while holding an item, and it appears in a shared GUI that everyone on the server can browse. Other players open the Auction House with /ah, scroll through listings, and click to purchase. Money transfers through Vault, the item goes to the buyer, and the seller gets paid minus any configured tax.

Auction Houses are wildly popular with players because they remove friction. There is no need to find someone's shop, no traveling to a marketplace district, and no guessing whether a shop is stocked. Every listed item is available instantly to every online player. For server operators, an Auction House is also easier to manage than a physical marketplace, no region plots to assign, no abandoned shops cluttering up spawn, and no disputes about shop locations.

Choosing an Auction House Plugin

Several Auction House plugins exist. The two most widely used are:

Plugin	Price	Key Features	Best For
AuctionHouse by klainmern	Free	Simple GUI, listing fees, tax, expiration, category filters	Small to medium servers that want a clean, no-fuss marketplace
zAuctionHouse	Premium	Bidding system, auto-sell, advanced categories, web interface	Large servers or networks that need auction-style bidding and analytics

For most single-server setups, the free AuctionHouse plugin by klainmern does everything you need. It supports fixed-price listings (not actual auctions despite the name), configurable taxes, and item expiration. This guide focuses primarily on that plugin, but the configuration principles apply to any similar plugin.

Installation

Download the AuctionHouse jar from SpigotMC and drop it into your plugins/ folder. You need Vault and an economy provider already running. Restart the server, the plugin generates its configuration at plugins/AuctionHouse/config.yml.

Verify the installation by running /ah in-game. You should see an empty GUI with category tabs. If the command is not recognized, check your startup log for errors. The most common problem is a missing Vault dependency or a Vault installation that has not hooked into any economy plugin.

Permissions Setup

Grant the following permissions through LuckPerms:

Permission	Description	Recommended Group
auctionhouse.use	Open the Auction House GUI	Default (all players)
auctionhouse.sell	List items for sale	Default
auctionhouse.sell.<amount>	Max concurrent listings (e.g., auctionhouse.sell.5)	Per-rank
auctionhouse.admin	Remove any listing, bypass limits	Admin only

Limiting the number of concurrent listings per rank is a smart progression tool. Give default players 3 listing slots, members 5, VIPs 10, and so on. This makes rank upgrades tangibly useful without being pay-to-win.

Configuring Listing Fees

A listing fee charges the seller upfront when they put an item on the Auction House. This fee is non-refundable, even if the item expires unsold. Listing fees serve two purposes: they discourage spam listings of worthless items, and they act as a money sink that helps balance your economy.

listing:
  fee:
    enabled: true
    amount: 10        # flat fee per listing
    percentage: false  # set to true to charge a % of the listing price instead

A flat fee works well for smaller servers. For larger economies, a percentage-based fee (1-3% of the listing price) scales better because it takes proportionally more money from expensive listings.

Tax on Sales

Separate from the listing fee, you can charge a tax when an item actually sells. The tax is deducted from the seller's payout:

tax:
  enabled: true
  percentage: 5   # seller receives 95% of the sale price

A 5% sales tax is the sweet spot for most servers. It is low enough that players do not feel punished for using the Auction House, but high enough to remove meaningful amounts of money from circulation. On a server with 50 daily active players making regular trades, a 5% tax can remove tens of thousands of currency per day, a significant anti-inflation mechanism.

Maximum Listings and Expiration

Control how long items stay listed before they expire and return to the seller. Also cap the total number of active listings to prevent the GUI from becoming an infinite scroll of junk:

listing:
  maxListings: 45         # per player
  expireTime: 48           # hours
  expireAction: RETURN     # RETURN sends the item back, DELETE destroys it

48 hours is a reasonable expiration window. It gives items enough time to sell across different time zones while keeping the marketplace fresh. If you set it too long (7+ days), the Auction House fills up with stale listings that nobody wants. If you set it too short (6 hours), players who list before logging off for the night never get a fair selling window.

When an item expires, it goes to a "collection box" that the player can open with /ah expired. Make sure players know about this, lost items due to uncollected expirations generate support tickets.

Banned Items

Some items should never appear on the Auction House. Restrict these in the config:

banned:
  items:
   , BEDROCK
   , BARRIER
   , COMMAND_BLOCK
   , SPAWNER
   , WRITTEN_BOOK

Ban any item that could be exploited, duplicated through bugs, or that you distribute exclusively through crates or events. Written books are worth banning because players can write offensive content and distribute it through the marketplace. Spawners should be banned if you sell them through a separate system like ShopGUI+ and do not want player-to-player spawner trading undercutting admin shop prices.

Vault Economy Integration

The Auction House hooks into Vault automatically at startup. If Vault is installed and an economy provider is registered, no additional configuration is needed. You can verify the connection by checking the server log for a message like [AuctionHouse] Economy provider found: EssentialsX Economy.

If you switch economy plugins mid-season (for example, moving from EssentialsX Economy to CMI Economy), restart the server and check that the Auction House picked up the new provider. Player balances should migrate through Vault transparently, but test a transaction in-game to be sure.

Common Issues

Items Vanishing After Purchase

This usually means the buyer's inventory was full. The Auction House attempts to give the item directly to the player's inventory. If there is no space, some plugins drop it on the ground, others send it to a collection box, and poorly coded ones lose it. Check your plugin's handling of full inventories and configure it to use a collection box or mail system as fallback.

Duplicate Listings

If a player can list the same item twice, a dupe exploit may be in play. Update to the latest version of the plugin and check for known bugs. On Paper servers, ensure that paper-global.yml has item-validation.resolve-selectors-in-commands set properly for your version.

Tax Not Being Applied

Double-check that tax.enabled is true and that the percentage is set correctly. Some plugins require a server restart (not reload) to pick up tax changes.

Auction House vs ChestShop, When to Use Each

These plugins are not mutually exclusive. Most successful economy servers run both:

• Auction House is best for quick, convenience-driven trades. Players list items they want to offload, browsers find deals, and transactions happen instantly regardless of location. It is ideal for consumables, mob drops, and common materials.
• ChestShop is best for persistent storefronts. Players who want to run an ongoing business selling specific items at specific prices build a physical shop. It adds roleplay value and gives players a reason to build in marketplace areas.

Running both creates a layered economy: casual trading happens on the Auction House, dedicated merchants operate ChestShops, and admin shops through ShopGUI+ provide the baseline pricing floor. That three-tier structure gives every type of player a way to engage with the economy on their own terms.

Need a server for this? Astroworld Hosting runs NVMe SSD, Pterodactyl panel, and DDoS protection on every plan. See features , plans from €6.39/mo.