# AuctionHouse<\/p>\n
**A complete server-side Auction House system for Minecraft 1.21.4 with built-in economy, advanced filtering, live search, pagination, and an intuitive chest-based GUI.**<\/p>\n
—<\/p>\n
### \u2500\u2500 Overview<\/p>\n
AuctionHouse provides a fully featured player-to-player marketplace accessible through a single command. Players can list items for sale, browse listings with filters and sorting, search by name, and purchase items — all through a clean inventory-based interface.<\/p>\n
The plugin ships with its own lightweight economy system. No external dependency is required.<\/p>\n
—<\/p>\n
### \u2500\u2500 Features<\/p>\n
**Marketplace**
\n– Browse all active listings in a paginated 28-slot GUI
\n– View detailed item information before purchasing
\n– Purchase confirmation screen to prevent misclicks
\n– Real-time seller notifications on sale
\n– Automatic listing expiration with configurable duration
\n– Collection box for expired and sold items
\n– Personal listings management with cancellation<\/p>\n
**Filtering & Sorting**
\n– 9 item categories — All, Weapons, Armor, Tools, Blocks, Food, Potions, Enchanted, Miscellaneous
\n– 6 sorting modes — Newest, Oldest, Price ascending, Price descending, Name A-Z, Name Z-A
\n– Live search through chat input with instant results
\n– Combined filters — search within a specific category with a chosen sort order
\n– Search auto-clears on GUI close for a fresh experience every time<\/p>\n
**Economy**
\n– Built-in balance system with configurable starting amount
\n– `\/balance` to check funds
\n– `\/pay` to transfer money between players
\n– `\/eco` admin commands to set, give, or take money
\n– Configurable sales tax deducted automatically
\n– Balance displayed directly in the Auction House GUI<\/p>\n
**Interface**
\n– Clean inventory GUI with glass pane borders
\n– Color-coded item lore with price, seller, time remaining, and per-unit cost
\n– Animated category cycling with representative icons
\n– Page indicators showing current position and total pages
\n– Collection box indicator showing pending items at a glance
\n– Sound effects for every interaction — open, click, buy, sell, error, page turn
\n– All sounds configurable in `config.yml`<\/p>\n
—<\/p>\n
### \u2500\u2500 Commands<\/p>\n
| Command | Description | Permission | **Aliases:** `\/ah` `\/hdv` `\/auction` | `\/bal` `\/money` | `\/sell` `\/ahlist`<\/p>\n —<\/p>\n ### \u2500\u2500 Permissions<\/p>\n | Permission | Description | Default | —<\/p>\n ### \u2500\u2500 Configuration<\/p>\n All settings are managed through a single `config.yml` file generated on first launch.<\/p>\n “`yaml **Configurable elements:** —<\/p>\n ### \u2500\u2500 How It Works<\/p>\n “` **Expired items** are automatically moved to the seller’s collection box and can be retrieved at any time through the GUI.<\/p>\n —<\/p>\n ### \u2500\u2500 Data Storage<\/p>\n All data is stored locally in JSON files inside the plugin folder:<\/p>\n – `auctions.json` — Active listings and collection boxes Items are serialized using Minecraft’s native format, preserving all NBT data including enchantments, custom names, lore, and durability.<\/p>\n Auto-save runs every 5 minutes. Data is also saved on server shutdown.<\/p>\n —<\/p>\n ### \u2500\u2500 Supported Platforms<\/p>\n AuctionHouse runs on all Paper-based server software:<\/p>\n – Paper Folia compatibility is handled automatically at runtime through a scheduler abstraction layer.<\/p>\n —<\/p>\n ### \u2500\u2500 Requirements<\/p>\n – **Paper 1.21.4+** or any compatible fork No external plugins required. Economy is fully self-contained.<\/p>\n —<\/p>\n *AuctionHouse — Simple, powerful, self-contained marketplace.*<\/p>\n","protected":false},"excerpt":{"rendered":" A complete server-side Auction House system for Minecraft 1.21.4 with built-in economy, advanced filtering, live search, pagination, and an intuitive chest-based GUI.<\/p>\n","protected":false},"featured_media":30707,"template":"","meta":{"_minecraft_slug":"bidvault","_minecraft_project_id":"iYWrjWph","_minecraft_author":"maxlananass","_minecraft_license":"MIT","_minecraft_downloads":28,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"bidvault.zip","_minecraft_size_bytes":74984,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:10:50.904274Z","_minecraft_date_created":"2026-03-04T23:33:30.633631Z","_minecraft_date_modified":"2026-03-03T04:02:29.734954Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/bidvault","_minecraft_icon_attachment_id":30707,"_minecraft_imported_at":"2026-06-01T13:11:42+00:00","_minecraft_import_hash":"7f08e49e38ae47c840d019239d6bd531","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,125,89,126,127,128,867,92],"mod_loader":[131,132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-30706","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|————-|————|
\n| `\/ah` | Open the Auction House | `auctionhouse.use` |
\n| `\/ahsell
\n| `\/ahsearch
\n| `\/ahcollect` | Open collection box | `auctionhouse.use` |
\n| `\/ahreload` | Reload configuration | `auctionhouse.admin` |
\n| `\/balance [player]` | Check balance | \u2500\u2500 |
\n| `\/pay
\n| `\/eco
\n|————|————-|———|
\n| `auctionhouse.use` | Access the auction house | Everyone |
\n| `auctionhouse.sell` | List items for sale | Everyone |
\n| `auctionhouse.admin` | Admin commands and economy management | OP |<\/p>\n
\ncurrency-symbol: “$”
\nstarting-balance: 5000.0
\nmax-listings-per-player: 10
\nmin-price: 1.0
\nmax-price: 1000000000.0
\ndefault-duration-hours: 48
\nsales-tax: 5.0
\nclear-search-on-close: true
\n“`<\/p>\n
\n– Currency symbol and starting balance
\n– Listing limits, price bounds, and duration
\n– Sales tax percentage
\n– Expiration check interval
\n– ActionBar and sound settings
\n– Search behavior on GUI close<\/p>\n
\nPlayer holds item
\n |
\n \/ahsell 1000
\n |
\n Item listed on AH
\n |
\n Other players browse \/ah
\n |
\n Click item –> View details –> Confirm purchase
\n |
\n Money transferred (minus tax)
\n Item given to buyer
\n Seller notified + earnings deposited
\n Sale appears in seller’s collection box
\n“`<\/p>\n
\n– `economy.json` — Player balances<\/p>\n
\n– Purpur
\n– Pufferfish
\n– Folia *(region-aware scheduling)*
\n– Leaves
\n– Gale
\n– Any Paper fork<\/p>\n
\n– **Java 21+**<\/p>\n