All Mods Resource Packs Data Packs Shaders Modpacks Plugins
AuctionHouse by ilius

AuctionHouse by ilius

by iliusIsOk • Downloads: 0 • Followers: 0
Description
Gallery
Changelog
Versions

⚡ AuctionHouse ⚡

A fast, clean auction house for Paper 1.20+

Minecraft Paper Folia Database


📦 Browse Listings

Scroll through pages, hover for details.

Browse

✅ Buy with Confidence

Confirmation screen before every purchase.

Buy

💰 Sell in Seconds

One command, confirm, listed.

Sell

🔍 Find What You Need

Filter by category, price, seller, or keyword.

Filters

📊 Price History

Bar chart with weekly paging and trends.

Price History

📋 Container Preview

Right-click shulkers to peek inside before buying.

Container Preview


✨ What's Included

For Players

  • Clean GUI — Everything runs through inventory menus, no chat spam
  • Buy & Sell Confirmation — Review before money moves
  • Mailbox — Bought items and expired listings go to your mailbox, nothing gets lost
  • Container Preview — See what's inside shulkers before buying
  • Seller Info — Right-click a listing to check the seller's stats and other items
  • 10 Categories — Weapons, Armor, Tools, Blocks, Food, Potions, Redstone, Decoration, Mob Drops, Misc
  • Filters & Search — Narrow down by category, price, seller, or keyword
  • Price History — Real bar chart with weekly views, highs/lows, and trend arrows
  • Datapack Items — Custom items show up correctly with their own price history

For Server Owners

  • Listing Fees & Tax — Flat fee, percentage, sales tax — all configurable
  • Vault + More — Works with Vault, PlayerPoints, EssentialsX, XP economy
  • LuckPerms — Set listing limits, expiry times, and fees per rank
  • SQLite / MySQL / MariaDB — SQLite out of the box, switch to MySQL whenever
  • Import Tool — Migrate from CrazyAuctions, zAuctionHouse, Fadah, or Akarian
  • Everything is Configurable — Messages, GUIs, icons, features — change whatever you want
  • Discord Webhooks — Get notified when items are listed or sold
  • PlaceholderAPI — Placeholders for scoreboards and tab lists
  • WorldGuard — Restrict the AH to certain regions
  • Folia Support — Works on Folia out of the box
  • Anti-Exploit — Atomic SQL, transaction locks, drag protection, dupe prevention

🔗 Part of the ilius Economy Ecosystem

AuctionHouse is the player-to-player marketplace of the ilius economy stack. Pair it with:

  • EconomyProvider — Modern Vault economy with banknotes, baltop GUI, and transaction logging
  • EconomyShop — Server shop with dynamic pricing, chest shops, and categories

All three plugins integrate seamlessly — same config style, same database support, same Discord. Use one or all three.


⌨️ Commands

Player

Command Description
/ah Open the auction house
/ah sell <price> [amt] List the item in your hand
/ah search <keyword> Search listings
/ah cancel <id> Cancel your listing
/ah active View your listings
/ah claim Claim mailbox items
/ah help Show commands

Admin

Command Description
/ah admin reload Reload config
/ah admin forcecancel <id> Remove any listing
/ah admin return <player> Return items to player
/ah admin stats Market statistics
/ah admin lookup <id> Inspect a listing
/ah admin transactions [player] Transaction log
/ah admin purge <days> Clear old records
/ah admin import Import from other plugins

🔑 Permissions

Permission Description Default
auction.use Open the AH true
auction.sell List items true
auction.buy Buy items true
auction.cancel Cancel own listings true
auction.admin Admin commands op
auction.admin.reload Reload config op

📥 Setup

  1. Drop the jar in plugins/
  2. Restart
  3. Edit plugins/AuctionHouse/config.yml if you want
  4. /ah admin reload and you're good

Want MySQL instead of SQLite? Open config.yml, set storage.type to mysql, then fill in host, port, database, username, and password under the storage.mysql section. Restart and you're done.


📦 Requirements

  • Paper 1.20+ (or Purpur, Folia, etc.)
  • Vault + an economy plugin
  • Optional: LuckPerms, PlaceholderAPI, WorldGuard, EconomyProvider, EconomyShop

💬 Need Help?

Join the Discord or open an issue.


🚀 Pro Edition — Available Now

Everything above, plus:

  • Buy Orders — Full order book matching engine with escrow and market demand GUI
  • Admin Dashboard — Live stats, module toggles, and moderation tools
  • Sell Wizard — Guided listing with auction types and price suggestions
  • Bulk Listings — List and buy partial stacks
  • Quantity Selector — Pick exactly how much to buy
  • Sale Limits — Per-player and per-group caps
  • CSV Export — Dump transactions for external analysis
  • Price Deviation Guards — Block manipulation attempts automatically
  • Price Drop Notifications — Alert players when items hit their target price

» Get AuctionHouse Pro on BuiltByBit «


Part of the ilius economy ecosystem. Built for servers that take their economy seriously.

All Versions

+ Add Version
Name Game version Platforms Published Downloads Actions
26.1.x 1.21.x
Folia Paper Purpur
6h ago 1
26.1.x 1.21.x
Folia Paper Purpur
6h ago 1
26.1.x 1.21.x
Folia Paper Purpur
6h ago 1
26.1.x 1.21.x
Folia Paper Purpur
6h ago 1
26.1.x 1.21.x
Folia Paper Purpur
6h ago 1
1.21.x
Folia Paper Purpur
6h ago 1
1.21.x 1.20.x
Folia Paper Purpur Spigot
6h ago 1
1.21.x
Folia Paper Purpur Spigot
6h ago 1
1.21.x
Folia Paper Purpur Spigot
6h ago 1
1.21.x
Folia Paper Purpur Spigot
6h ago 1
1.21.x
Folia Paper Purpur Spigot
6h ago 1
1.21.x 1.20.x
Folia Paper Purpur Spigot
6h ago 1
## AuctionHouse 1.1.4

### Fixed
  • GUI config files now actually work.** Every button in guis/*.yml honours material,
name, lore, glow, custom-model-data and skull-texture. Many screens previously
read only slot and drew a hardcoded icon — filter menu, sell/buy confirmation, quantity
selector, price history and seller info.
  • Quantity selector: the item preview was defined in config but never drawn.
  • Price history range toggle typo ("Currenly" → "Currently").

### Added
  • guis/buy-confirmation.yml — this screen had no config file at all.
  • Newly configurable: price history range toggles and chart border; seller info admin
panel and View Listings.

### Changed
  • Filter menu icons now match the config file: Apply LIME_CONCRETE, Sort COMPARATOR,
Search OAK_SIGN.
  • sell-confirmation.yml is auto-migrated to the 9-slot layout the screen actually used.
Edited files are left alone.
  • Removed the dead gui.filter section from config.yml — guis/filter-menu.yml owns it.

> Button text still comes from messages.yml until you edit name/lore in the GUI file,
> so existing translations keep working. *(thanks Toothy Deerryte)*
## AuctionHouse v1.1.3 — Hotfix

### Bug Fixes

  • Fixed harmless "Duplicate column/key name" warning spam on every restart with MySQL
  • v1.1.2 Changelog**

  • Bug Fixes**
  • Fixed AuctionHouse failing to load on Folia servers — the plugin is now correctly marked as Folia-compatible
  • v1.1.1 Changelog**

  • Compatibility**
  • Restored backwards compatibility with Paper 1.21.x and Java 21
  • Still loads cleanly on Paper 26.1+ with Java 25 — one build works on both

  • Bug Fixes**
  • Update checker now compares versions semantically instead of by string equality (no more "new version available" when you're already on a newer build)
  • Update checker safely ignores garbage / outage responses from SpigotMC
  • Fixed a build issue where plugin.yml versions could lag behind the actual release

  • Improvements**
  • config.yml now self-heals on startup — keys added in newer plugin versions are automatically merged into older configs. Fixes "admin GUI toggle doesn't save" symptoms caused by stale configs missing newer keys (e.g. modules.buyorders on configs pre-dating the Buy Orders feature)
  • v1.1.0 Changelog**

  • Compatibility**
  • Updated to support Paper 26.1+ (Minecraft 26.1.2 and later)
  • Now requires Java 25 — matches the new Paper server runtime

  • Note**
  • Stay on the previous version if you're running Paper 1.21.x or Java 21

  • v1.0.4.2 Changelog**

  • Improvements**
  • Mailbox GUI now paginates at the database level — opens instantly regardless of mailbox size
  • Increased default mailbox capacity from 100 to 500 items per player (configurable, LuckPerms-overridable)
  • Lowered default expiry check interval from 20 minutes to 5 minutes for faster auction turnover
[1.0.4] 1.0.4 by iliusIsOk on Oct 15, 2026
Download
  • v1.0.4 Changelog**

  • Bug Fixes**
  • Fixed a race condition where expired auctions could be delivered to both the buyer and returned to the seller's mailbox under high load
  • Fixed memory leak: GUI click cooldowns were never cleared, accumulating one entry per unique player forever
  • Fixed memory leak: mailbox cache was retained for offline players indefinitely
  • Fixed memory leak: transaction lock map could grow unbounded if cleanup was missed on exception paths
  • Async-wrapped seller info GUI back button — no longer blocks the main thread on a database query

  • Compatibility**
  • Now works on Spigot 1.20+** (previously Paper-only) — runtime detection automatically uses the right serialization format
  • Backwards-compatible item storage — existing databases work without migration on either platform
  • Folia and Purpur still fully supported

  • Improvements**
  • Added background sweep task that removes idle transaction locks every 5 minutes
  • Removed unused legacy code paths to reduce footprint
  • Added 9 new automated stress tests covering memory leaks, lock contention, and concurrent load (106 total tests)

  • AuctionHouse v1.0.3.1 (patch)**

  • Fixed mailbox items lost when inventory is full — overflow drops at your feet
  • Fixed a race condition in GUI click rate limiting
  • Switched from MySQL Connector (GPL) to MariaDB Connector (LGPL) — works with both MySQL and MariaDB
  • Fixed character encoding to utf8mb4 for special characters
  • Replaced sign-based text input with chat-based input — no external dependencies
  • v1.0.3 Changelog**

  • Bug Fixes**
  • Custom datapack items now display proper names everywhere instead of raw translation keys
  • Mailbox items no longer silently lost when inventory is full — overflow drops at your feet
  • Fixed a race condition in GUI click rate limiting that could allow click-spam exploits
  • Fixed price history query missing a safety limit — large databases no longer risk lag spikes
  • Removed invalid CHAIN material from default categories (removed in newer Paper versions)

  • MySQL / MariaDB**
  • Fixed character encoding to utf8mb4 — item names with special characters no longer corrupt
  • Fixed MySQL driver isolation to prevent classpath conflicts with other plugins
  • Added missing performance indexes on transaction queries
  • Fixed index creation compatibility with MySQL 5.7 and older MariaDB versions
  • Removed deprecated autoReconnect flag that could silently lose transaction state

  • Improvements**
  • Auction listings now track material type for faster search and matching
  • Centralized item name resolution across all GUIs and messages
[1.0.2] v1.0.2 Changelog by iliusIsOk on Oct 15, 2026
Download
Bug Fixes

  • Fixed Discord webhook reporting wrong quantity for listings (showed x1 instead of actual amount)

Improvements

  • Migrated item serialization to Paper's modern NBT format — safer, cross-version compatible, and ready for 26.1
  • Existing auction data loads seamlessly with automatic legacy format detection
  • Replaced deprecated API calls for future-proofing
🛡️ Security
  • Fixed potential item duplication via mailbox claim-all
  • Fixed potential item duplication on partial buy revert
  • Fixed transaction lock race condition under concurrent load
  • Added InventoryDragEvent handler to prevent item loss in GUIs
  • Added rate limiting to My Listings GUI clicks
  • Improved deserialization safety for corrupt item data
  • Added query limits to prevent memory issues on large servers

📊 Price History
  • New bar chart style with 5 height levels (stock market style)
  • Added price scale labels on both sides (High/Avg/Low)
  • Added date labels on bottom row
  • Added peak indicator with enchantment glow on highest price
  • Added week paging — view 7, 14, or 30 day ranges
  • Custom datapack items now get separate price histories
  • Fixed title showing raw translation keys for datapack items

🔧 Bug Fixes
  • Fixed mob drops category not showing items (magma cream, string, etc.)
  • Fixed container blacklist not scanning shulker box contents
  • Fixed miscellaneous category icon (was showing chest, now compass)
  • Fixed filter hopper showing raw message key
  • Fixed buy confirmation GUI not opening
  • Fixed price history showing wrong low price with single data point
  • Fixed expiry check interval now configurable

✨ New Features
  • Buy confirmation GUI — review purchases before committing
  • Right-click listings to view seller info
  • Seller info shows stats, active listings, and "View Listings" button
  • Admin seller info shows additional data (IP, first join, etc.)
  • Configurable command cooldown
Initial release

  • Full GUI auction house system
  • Buy & sell confirmation screens
  • 10 item categories with filters
  • Price history charts
  • Container preview (shulker boxes)
  • Seller profiles
  • Mailbox system with zero item loss
  • SQLite, MySQL, and MariaDB support
  • LuckPerms, PlaceholderAPI, WorldGuard integration
  • Discord webhooks
  • Folia compatible
  • Migration from CrazyAuctions, zAuctionHouse, Fadah, Akarian
AuctionHouse by ilius Icon
Download AuctionHouse by ilius
Select game version
Select platform