🏆 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>