AuctionHouse

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.

---

Overview

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.

The plugin ships with its own lightweight economy system. No external dependency is required.

---

Features

Marketplace

• Browse all active listings in a paginated 28-slot GUI
• View detailed item information before purchasing
• Purchase confirmation screen to prevent misclicks
• Real-time seller notifications on sale
• Automatic listing expiration with configurable duration
• Collection box for expired and sold items
• Personal listings management with cancellation

Filtering & Sorting

• 9 item categories -- All, Weapons, Armor, Tools, Blocks, Food, Potions, Enchanted, Miscellaneous
• 6 sorting modes -- Newest, Oldest, Price ascending, Price descending, Name A-Z, Name Z-A
• Live search through chat input with instant results
• Combined filters -- search within a specific category with a chosen sort order
• Search auto-clears on GUI close for a fresh experience every time

---

Commands

Command	Description	Permission
/ah	Open the Auction House	auctionhouse.use
/ahsell <price>	List the held item for sale	auctionhouse.sell
/ahsearch <query>	Search listings by name	auctionhouse.use
/ahcollect	Open collection box	auctionhouse.use
/ahreload	Reload configuration	auctionhouse.admin
/balance [player]	Check balance	──
/pay <player> <amount>	Send money	──
/eco <set|give|take> <player> <amount>	Manage economy	auctionhouse.admin

Aliases: /ah /hdv /auction | /bal /money | /sell /ahlist

---

Permissions

Permission	Description	Default
auctionhouse.use	Access the auction house	Everyone
auctionhouse.sell	List items for sale	Everyone
auctionhouse.admin	Admin commands and economy management	OP

---

Configuration

All settings are managed through a single config.yml file generated on first launch.

currency-symbol: "$"
starting-balance: 5000.0
max-listings-per-player: 10
min-price: 1.0
max-price: 1000000000.0
default-duration-hours: 48
sales-tax: 5.0
clear-search-on-close: true

Configurable elements:

• Currency symbol and starting balance
• Listing limits, price bounds, and duration
• Sales tax percentage
• Expiration check interval
• ActionBar and sound settings
• Search behavior on GUI close

---

Data Storage

All data is stored locally in JSON files inside the plugin folder:

• auctions.json -- Active listings and collection boxes
• economy.json -- Player balances

Items are serialized using Minecraft's native format, preserving all NBT data including enchantments, custom names, lore, and durability.

Auto-save runs every 5 minutes. Data is also saved on server shutdown.