OutAuction
🏆OutAuction — Powerful auction house system with stylish GUI, 🔧 fully customizable sounds, and 📜 complete transaction history. 💰 Vault support, 🚫 item blacklist
101
Quick challenge
How far can you run before the mobs catch you?
Minecraft check
Confirm your run
Complete the quick check to get your code.
OutAuction
🏆 OutAuction — Ultimate Auction House System 🏆
<b>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.</b>
---
🏪 About OutAuction ⚠️ needed Vault ⚠️
complete auction house ecosystem 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 | |---------|-------------| | 💾 SQLite Storage | List any item with custom pricing and automatic fee calculation | | 💾 SQLite Storage | Purchase items immediately with one click | | 💾 SQLite Storage | Search for specific items across all listings | | 💾 SQLite Storage | Beautiful page navigation with configurable items per page | | 💾 SQLite Storage | Listings automatically expire after configurable duration | | 💾 SQLite Storage | Reliable database with auto-vacuum and history cleanup |
📜 Complete Transaction History
| Feature | Description | |---------|-------------| | 🗑️ Auto-Cleanup | Track everything you've bought with dates and prices | | 🗑️ Auto-Cleanup | Monitor your sold items and earnings | | 🗑️ Auto-Cleanup | View items that weren't sold | | 🗑️ Auto-Cleanup | Customizable date display (yyyy-MM-dd HH:mm) | | 🗑️ Auto-Cleanup | Browse through up to 12 pages of transaction history | | 🗑️ Auto-Cleanup | Automatically remove old history after 3 days (configurable) |
🎨 GUI & Design
| Feature | Description | |---------|-------------| | 🔄 Auto-Refresh | Main auction, My Listings, History, Search, Confirm purchase | | 🔄 Auto-Refresh | RGB color support for all GUI titles | | 🔄 Auto-Refresh | Seller, price, amount, time left with beautiful formatting | | 🔄 Auto-Refresh | Configurable border materials and patterns | | 🔄 Auto-Refresh | Safety confirmation before purchasing | | 🔄 Auto-Refresh | GUI updates automatically every 20 seconds (configurable) |
🔊 Audio Experience
| Feature | Description | |---------|-------------| | ⚙️ Per-Sound Control | Every action has its own configurable sound | | ⚙️ Per-Sound Control | Open, close, click, page turn, refresh | | ⚙️ Per-Sound Control | Purchase success/fail, item listed, item cancelled | | ⚙️ Per-Sound Control | Auction expired, outbid notifications | | ⚙️ Per-Sound Control | Enable/disable individual sounds with custom volume/pitch |
⚙️ Economy & Commission
| Feature | Description | |---------|-------------| | 💳 Balance Checking | Full economy integration with any Vault-compatible plugin | | 💳 Balance Checking | Configurable fee percentage (e.g., 5%) on all sales | | 💳 Balance Checking | Min/max price limits to prevent economy abuse | | 💳 Balance Checking | Beautiful price formatting with configurable symbols | | 💳 Balance Checking | Automatic insufficient funds handling |
👤 Player Features
| Feature | Description | |---------|-------------| | 📱 Join Notifications | View and manage your active auctions | | 📱 Join Notifications | Remove your items from auction anytime | | 📱 Join Notifications | Get notified when items sell, expire, or you're outbid | | 📱 Join Notifications | Sell entire item stacks at once with total price calculation | | 📱 Join Notifications | Simple `/auction sell <price>` command while holding item | | 📱 Join Notifications | See outbid notifications when you log in |
👑 Admin Features
| Feature | Description | |---------|-------------| | 🔧 Permission Control | `/auction reload` - Reload configuration without restart | | 🔧 Permission Control | Track all transactions, expirations, and admin actions | | 🔧 Permission Control | Prevent specific items from being listed | | 🔧 Permission Control | 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️⃣ | Enjoy! — Get the latest `.jar` from Enjoy! | | 2️⃣ | Enjoy! — Place the JAR into your server's `plugins/` folder | | 3️⃣ | Enjoy! — Restart your server (or use `/reload` if you must) | | 4️⃣ | Enjoy! — 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
```yaml
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
📁 GUI Configuration
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(ʏᴏᴜʀ ɪᴛᴇᴍ)"
📁 Sound Configuration
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"
📁 Messages Configuration
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ɪᴍᴜᴍ ɴᴜᴍʙᴇʀ ᴏꜰ ʟɪꜱᴛɪɴɢꜱ!"
