AuctionHouse
Global auction house for player-to-player trading. List items, place bids and buy instantly through a GUI interface.
EconomyWhat is AuctionHouse?
AuctionHouse provides a server-wide marketplace where players list items for others to buy, all through a GUI rather than physical shops. A seller lists an item with a price (and optionally as a timed auction accepting bids); buyers browse the auction house, filter by category, and buy instantly or place a bid. Expired and sold items, and collected funds, are handled through the interface, and a tax rate can skim each sale as a money sink. It complements chest shops by giving players a central, always-accessible place to trade without needing to build or visit a shop. Money flows through a Vault economy.
Who it's for: Economy servers wanting a centralised player-to-player marketplace alongside or instead of physical shops, so trading does not depend on both players being online at a shop. It is built and maintained by Kiran Hart and sits in the economy category.
Key features of AuctionHouse
- Item listing
- Bidding system
- Buy-it-now option
- Category filtering
- Expired item collection
- Transaction history
- Tax system
- Admin controls
How to install AuctionHouse
AuctionHouse runs on Spigot or Paper servers. Maintained for current Spigot/Paper versions; built around a Vault economy.
- 1Stop your server, or have it ready to restart. Always back up your world and plugins folder before adding a new plugin.
- 2Download AuctionHouse.jar (a build matching your server version) and place it in your server's /plugins folder.
- 3AuctionHouse requires Vault — install that plugin first or AuctionHouse will not start.
- 4Start the server fully. AuctionHouse generates its configuration files on first launch — stop the server, edit them to taste, then start again.
- 5Confirm it loaded by checking the console for AuctionHouse on startup, or by running one of its commands in-game.
Note: AuctionHouse requires Vault and an economy plugin. Drop the jar into /plugins and restart to generate its config, where you set the tax rate, listing limits and durations. Players open it with /ah and list with /ah sell <price>. No world building is needed — the marketplace is entirely GUI-based and server-wide.
AuctionHouse commands and permissions
Main commands
/ah- Opens the auction house GUI to browse and buy listings.
/ah sell- Lists the held item for sale at the given price (or as an auction).
/ah search- Searches current listings for a specific item.
/ah expired- Opens the collection bin for the player's unsold, expired listings.
Permission nodes
auctionhouse.use- Allows opening and buying from the auction house.
auctionhouse.sell- Allows listing items for sale.
auctionhouse.admin- Grants administrative control of listings.
AuctionHouse FAQ
How do players sell an item on the auction house?
Hold the item and run /ah sell <price> to list it for instant purchase, or list it as a timed auction that accepts bids if that mode is enabled. The item appears in the auction house GUI for everyone, and the seller receives the money (minus any tax) when it sells.
Does the auction house need an economy plugin?
Yes. It uses Vault and an economy plugin to handle payments between buyers and sellers, so both must be installed. Without an economy provider there is no currency for the marketplace to operate on.
What happens to items that do not sell?
Expired listings are returned to the seller through a collection bin opened with /ah expired, so unsold items are not lost — the player just reclaims them. This is also where items go if a listing's duration runs out before anyone buys.
How is the auction house different from chest shops?
Chest shops are physical, located in the world, and require the shop to be stocked and found. The auction house is a central GUI marketplace accessible from anywhere with /ah, so trading does not depend on building shops or both players being at the same location. Many servers run both.
Can I tax auction sales?
Yes. A configurable tax can be applied to each sale, acting as a money sink that helps control inflation in the server economy. Set the rate in the config; it is deducted from the seller's proceeds automatically when an item sells.
Features
- Item listing
- Bidding system
- Buy-it-now option
- Category filtering
- Expired item collection
- Transaction history
- Tax system
- Admin controls
Commands
/ah/ah sell/ah search/ah expired/ah activePermissions
auctionhouse.useauctionhouse.sellauctionhouse.admin