
🏆 OutAuction — Ultimate Auction House System 🏆
The most advanced, feature-rich auction house plugin for Minecraft. Beautiful GUI design, stunning sound effects, complete transaction history, and unparalleled customization for your server's economy.
🏪 About OutAuction ⚠️ needed Vault ⚠️
OutAuction is not just another auction plugin — it's a complete auction house ecosystem for your Minecraft server. Unlike standard plugins that offer basic listing functionality, OutAuction delivers a professional marketplace experience with stunning GUI design, comprehensive transaction tracking, and unparalleled customization options.
Whether you're running a small survival server with friends or a large economy-focused network with hundreds of players, OutAuction adapts to your needs with its flexible configuration system, complete transaction history, and performance-optimized SQLite database.
✨ Feature Showcase
🏪 Core Auction Features
| Feature | Description |
|---|
| 📦 Item Listing | List any item with custom pricing and automatic fee calculation |
| ⚡ Instant Buy | Purchase items immediately with one click |
| 🔍 Advanced Search | Search for specific items across all listings |
| 📊 Pagination | Beautiful page navigation with configurable items per page |
| ⏱️ Auto-Expire | Listings automatically expire after configurable duration |
| 💾 SQLite Storage | Reliable database with auto-vacuum and history cleanup |
📜 Complete Transaction History
| Feature | Description |
|---|
| 📥 Purchase History | Track everything you've bought with dates and prices |
| 📤 Sales History | Monitor your sold items and earnings |
| ⏳ Expired Listings | View items that weren't sold |
| 📅 Date Formatting | Customizable date display (yyyy-MM-dd HH:mm) |
| 📊 History Pages | Browse through up to 12 pages of transaction history |
| 🗑️ Auto-Cleanup | Automatically remove old history after 3 days (configurable) |
🎨 GUI & Design
| Feature | Description |
|---|
| 🎯 Multiple GUIs | Main auction, My Listings, History, Search, Confirm purchase |
| 🖼️ Custom Titles | RGB color support for all GUI titles |
| 📋 Detailed Lore | Seller, price, amount, time left with beautiful formatting |
| 🔲 Border System | Configurable border materials and patterns |
| ✅ Confirm Menu | Safety confirmation before purchasing |
| 🔄 Auto-Refresh | GUI updates automatically every 20 seconds (configurable) |
🔊 Audio Experience
| Feature | Description |
|---|
| 🔊 30+ Custom Sounds | Every action has its own configurable sound |
| 🎵 GUI Sounds | Open, close, click, page turn, refresh |
| 💰 Transaction Sounds | Purchase success/fail, item listed, item cancelled |
| ⏰ Notification Sounds | Auction expired, outbid notifications |
| ⚙️ Per-Sound Control | Enable/disable individual sounds with custom volume/pitch |
⚙️ Economy & Commission
| Feature | Description |
|---|
| 💰 Vault Support | Full economy integration with any Vault-compatible plugin |
| 📊 Commission System | Configurable fee percentage (e.g., 5%) on all sales |
| 💵 Price Validation | Min/max price limits to prevent economy abuse |
| 🪙 Currency Display | Beautiful price formatting with configurable symbols |
| 💳 Balance Checking | Automatic insufficient funds handling |
👤 Player Features
| Feature | Description |
|---|
| 📋 My Listings | View and manage your active auctions |
| 🗑️ Cancel Listings | Remove your items from auction anytime |
| 🔔 Smart Notifications | Get notified when items sell, expire, or you're outbid |
| 📦 Stack Selling | Sell entire item stacks at once with total price calculation |
| ⚡ Quick Listing | Simple /auction sell <price> command while holding item |
| 📱 Join Notifications | See outbid notifications when you log in |
👑 Admin Features
| Feature | Description |
|---|
| ⚙️ Config Reload | /auction reload - Reload configuration without restart |
| 📊 Full Logging | Track all transactions, expirations, and admin actions |
| 🚫 Item Blacklist | Prevent specific items from being listed |
| 📈 Database Management | Auto-vacuum and history cleanup for optimal performance |
| 🔧 Permission Control | Granular permission system for all features |
📊 bStats Metrics
OutAuction uses bStats to collect anonymous usage statistics. This helps us improve the plugin based on real usage data.
📥 Installation Guide
| Step | Action |
|---|
| 1️⃣ | Download — Get the latest .jar from Modrinth |
| 2️⃣ | Install — Place the JAR into your server's plugins/ folder |
| 3️⃣ | Restart — Restart your server (or use /reload if you must) |
| 4️⃣ | Configure — Edit plugins/OutAuction/config.yml to your liking |
| 5️⃣ | Enjoy! — Players can now use /auction to start trading |
** ⚠️ needed Vault ⚠️
🎮 Commands & Permissions
👤 Player Commands
| Command | Description | Permission | Default |
|---|
/auction | Open the main auction GUI | outauction.use | ✅ All players |
/auction sell <price> | List held item for sale | outauction.use | ✅ All players |
/auction my | View your active listings | outauction.use | ✅ All players |
/auction history | View transaction history | outauction.use | ✅ All players |
/auction search <query> | Search for specific items | outauction.use | ✅ All players |
/auction help | Show help menu | outauction.use | ✅ All players |
👑 Admin Commands
| Command | Description | Permission | Default |
|---|
/auction reload | Reload plugin configuration | outauction.admin | ❌ Ops only |
🔑 Permissions
| Permission | Description | Default |
|---|
outauction.* | All permissions | ❌ Ops only |
outauction.use | Use basic auction commands | ✅ All players |
outauction.admin | Admin commands (reload) | ❌ Ops only |
outauction.bypass.limit | Bypass max listings limit | ❌ Ops only |
outauction.bypass.blacklist | Bypass item blacklist | ❌ Ops only |
⚙️ Configuration Deep Dive
📁 Database & Core Settings
# Database configuration
database:
sqlite:
file: "auction.db"
auto-vacuum: true # Automatically optimize database size
keep-history-days: 3 # How long to keep transaction history
auction:
default-duration: 108600 # Default listing duration in seconds (30 hours)
max-listings-per-player: 5 # Maximum active listings per player
commission: 0.05 # Auction house fee percentage (0.05 = 5%)
min-price: 100 # Minimum price per item
max-price: 9999999999 # Maximum price per item
allow-bidding: false # Enable/disable bidding system
allow-direct-buy: true # Enable/disable instant buy feature
sell-entire-stack: true # Allow selling whole stacks at once
</details><details> <summary>📁 GUI Configuration</summary>
yaml
gui:
update-interval: 400 # GUI refresh rate in ticks (20 ticks = 1 second)
border-material: "BLACK_STAINED_GLASS_PANE"
# Confirm menu slot configuration
confirm:
confirm-slots: [0, 1, 2, 9, 10, 11, 18, 19, 20]
cancel-slots: [5, 6, 7, 14, 15, 16, 23, 24, 25]
item-slot: 13
border-slots: [3, 4, 8, 12, 17, 21, 22, 26]
# GUI Titles (supports RGB colors)
titles:
main: "&7&lᴀᴜᴄᴛɪᴏɴ ꜱɪᴛᴇ &8({page}/{total})"
my-listings: "&7&lᴍʏ ʟɪꜱᴛɪɴɢꜱ &8({page}/{total})"
history: "&7&lᴛʀᴀɴꜱᴀᴄᴛɪᴏɴ ʜɪꜱᴛᴏʀʏ &8({page}/{total})"
confirm: "&7&lᴄᴏɴꜰɪʀᴍ ᴘᴜʀᴄʜᴀꜱᴇ"
search: "&7&lꜱᴇᴀʀᴄʜ: &f{query} &8({page}/{total})"
# Item Lore
lore:
seller: "&7ꜱᴇʟʟᴇʀ: &f{seller}"
price: "&7ᴘʀɪᴄᴇ: &e&l{price}$"
amount: "&7ᴀᴍᴏᴜɴᴛ: &b&l{amount}"
total-price: "&7ᴛᴏᴛᴀʟ: &e&l{total}$"
time-left: "&7ᴛɪᴍᴇ ʟᴇꜰᴛ: &f{time}"
your-item: "&8&o(ʏᴏᴜʀ ɪᴛᴇᴍ)"
</details><details> <summary>📁 Sound Configuration</summary>
yaml
sounds:
enabled: true
gui_open: "BLOCK_CHEST_OPEN, 0.5, 1.0"
gui_close: "BLOCK_CHEST_CLOSE, 0.5, 1.0"
button_click: "UI_BUTTON_CLICK, 0.5, 1.0"
page_turn: "ITEM_BOOK_PAGE_TURN, 0.5, 1.0"
refresh: "BLOCK_LEVER_CLICK, 0.5, 1.0"
purchase_success: "ENTITY_PLAYER_LEVELUP, 0.5, 1.0"
purchase_fail: "ENTITY_VILLAGER_NO, 0.5, 1.0"
item_listed: "ENTITY_ITEM_PICKUP, 0.5, 1.0"
item_cancelled: "ENTITY_ITEM_PICKUP, 0.5, 1.0"
error: "ENTITY_VILLAGER_NO, 0.5, 1.0"
not_enough_money: "ENTITY_VILLAGER_NO, 0.5, 1.0"
auction_expired: "BLOCK_NOTE_BLOCK_PLING, 0.5, 1.0"
</details><details> <summary>📁 Messages Configuration</summary>
yaml
messages:
auction:
# Listing messages
item-listed: "&aꜱᴜᴄᴄᴇꜱꜰᴜʟʟʏ ʟɪꜱᴛᴇᴅ &f{item} &7{amount}x &aꜰᴏʀ &e{price}$"
item-removed: "&aꜱᴜᴄᴄᴇꜱꜰᴜʟʟʏ ʀᴇᴍᴏᴠᴇᴅ &f{item} &aꜰʀᴏᴍ ᴀᴜᴄᴛɪᴏɴ"
# Sale notifications
item-sold: "&aʏᴏᴜʀ &f{item} &7{amount}x &aᴡᴀꜱ ꜱᴏʟᴅ ꜰᴏʀ &e{price}$"
item-bought: "&aʏᴏᴜ ʙᴏᴜɢʜᴛ &f{item} &7{amount}x &aꜰᴏʀ &e{price}$"
# Error messages
not-enough-money: "&cʏᴏᴜ ᴅᴏɴ'ᴛ ʜᴀᴠᴇ ᴇɴᴏᴜɢʜ ᴍᴏɴᴇʏ!"
invalid-item: "&cʏᴏᴜ ᴍᴜꜱᴛ ʜᴏʟᴅ ᴀɴ ɪᴛᴇᴍ ɪɴ ʏᴏᴜʀ ʜᴀɴᴅ!"
max-listings: "&cʏᴏᴜ ʜᴀᴠᴇ ʀᴇᴀᴄʜᴇᴅ ᴛʜᴇ ᴍᴀxɪᴍᴜᴍ ɴᴜᴍʙᴇʀ ᴏꜰ ʟɪꜱᴛɪɴɢꜱ!"
</details>