AuctionHouse

• Auction House GUI
  Browse available items through a clean 54-slot interface.
  
• 45 Listing Slots
  Display up to 45 auction listings per page.
  
• Buy Items
  Purchase items directly from other players using your server economy.
  
• Sell Items
  Create listings through an easy selling interface.
  
• Search
  Quickly search the marketplace for specific items or sellers.
  
• Sorting
  Sort listings by:
  Newest, Oldest, Lowest Price, Highest Price and Expiring Soon.
  
• My Auctions
  View and manage your own active listings.
  
• Auction Claims
  Safely retrieve items from expired or incomplete transactions.
  
• Pagination
  Browse large marketplaces across multiple pages.
  
• Compact Economy Format
  Supports readable prices such as:
  1k, 1.5k, 10m, 500m, 1b and 1t.
  
• Listing Limits
  Set different maximum listing limits using permissions.
  
• Listing Fees
  Configure a fee charged when creating an auction.
  
• Sales Tax
  Configure a percentage tax for successful transactions.
  
• Item Restrictions
  Block specific materials or items containing restricted lore.
  
• Inventory Protection
  Protect items when a player's inventory is full.
  
• Persistent Listings
  Auction data remains available after server restarts.
  
• No Database Required
  No MySQL, PostgreSQL or external database is required.
  
• Folia Compatible
  Designed with modern server scheduling in mind.
  
• Fully Configurable
  Customize the Auction House to match your server.
  

Open the Auction House:

/ah

Click any listing to view its information.

Listings can display:

• Item
• Amount
• Seller
• Price
• Time remaining
• Listing ID

Click the listing to purchase it.

The item is delivered directly to the buyer's inventory.



Use:

/ah sell

AuctionHouse will open the selling interface.

After selecting the item, enter the total selling price in chat.

Supported formats:

1k
1.5k
10m
500m
1b
1t

Normal numbers are also supported:

1000
50000

To cancel:

Type cancel

Cancelling the price input will safely return the item.



AuctionHouse makes it easy to find the item you want.

Available sorting modes:

• Newest — Newest listings first.
• Oldest — Oldest listings first.
• Price Lowest — Cheapest listings first.
• Price Highest — Most expensive listings first.
• Expiring Soon — Listings closest to expiration first.

Players can also search the marketplace for specific items or sellers.



Auction Claims help prevent items from being lost.

If an item cannot be delivered because the player's inventory is full, the item can be protected in the Claims system.

Depending on configuration, expired listings can also be moved to Claims.

Open Claims with:

/ah claims

Players can safely retrieve their items whenever they have enough inventory space.



AuctionHouse is designed to handle common transaction problems safely.

Protection includes:

• Full inventory protection
• Cancelled listing protection
• Expired listing handling
• Invalid price protection
• Restricted item protection
• Listing limit protection
• Economy transaction validation
• Failed item delivery handling

The goal is simple:

Keep player items and economy transactions safe.



AuctionHouse includes an easy-to-edit config.yml.

Server owners can configure:

• Auction House enabled/disabled
• Listing duration
• Expiration check interval
• Default listing limit
• Permission-based listing limits
• Minimum price
• Maximum price
• Listing fee
• Sales tax
• Blocked materials
• Blocked lore
• Expired auction behavior
• GUI titles
• GUI size
• Listing slots
• Money formatting

Most settings can be changed without modifying the plugin.



AuctionHouse uses Vault to connect with your server economy.

Required:

• Vault
• A Vault-compatible economy provider

For example:

• EssentialsX Economy
• Other Vault-compatible economy plugins

AuctionHouse itself does not provide a separate economy system.

Command	Description
/ah	Open the Auction House.
/ah sell	Open the selling interface.
/ah my	View your active auctions.
/ah claims	View your auction claims.
/ah search <text>	Search auction listings.
/ah reload	Reload AuctionHouse configuration.
/ah help	Show available commands.

Basic Permissions

• auctionhouse.use
  Allows the player to open and use the Auction House.
  
• auctionhouse.sell
  Allows the player to create auction listings.
  
• auctionhouse.buy
  Allows the player to purchase auction listings.
  
• auctionhouse.admin
  Provides access to administrative Auction House features.
  

Listing Limit Permissions

These permissions determine how many active auctions a player can have at the same time.

• auctionhouse.limit.5
  Allows up to 5 active listings.
  
• auctionhouse.limit.10
  Allows up to 10 active listings.
  
• auctionhouse.limit.25
  Allows up to 25 active listings.
  
• auctionhouse.limit.50
  Allows up to 50 active listings.
  
• auctionhouse.limit.100
  Allows up to 100 active listings.
  
• auctionhouse.limit.250
  Allows up to 250 active listings.
  

If a player has multiple listing-limit permissions,
the highest available limit is used.

Requirement	Support
Minecraft	Java Edition
Server	Paper 26.2
Java	Java 25
Economy	Vault + compatible economy provider
Folia	Compatible
Bedrock	Not supported

1. Install Paper 26.2.
2. Run your server using Java 25.
3. Install Vault.
4. Install a Vault-compatible economy provider.
5. Place AuctionHouse.jar into your server's plugins folder.
6. Restart the server.
7. Run /ah.
   

AuctionHouse automatically creates its required configuration and data files on first startup.



AuctionHouse does not require MySQL, PostgreSQL or SQLite.

Listings and claims are stored locally using YAML files.

This keeps installation simple and avoids the need for an external database.



AuctionHouse is designed with modern Paper scheduling APIs and supports Folia-compatible environments.

The plugin is built for modern server software rather than relying on legacy scheduling patterns.



Need help or found a problem?

When reporting an issue, please provide:

• AuctionHouse version
• Minecraft/Paper version
• Java version
• Relevant console error
• Steps to reproduce the problem

For feature suggestions, include a short explanation of the feature and how you would like it to work.