ozAuctions

A modern, premium, cross-version Auction House plugin built for performance, customization, and scalability.

ozAuctions is designed to provide a smooth auction experience for both players and server administrators. Whether you're running a small survival server or a large network, ozAuctions offers powerful features, intuitive menus, and extensive customization without sacrificing performance.

✨ Features

• 🌍 Cross-version support (1.16.5+)
• 📦 One JAR supporting all compatible versions
• ⚡ Fast and optimized with asynchronous database operations
• 📄 Paginated auction menus
• 🔍 Advanced search system with Sign GUI
• 📊 Multiple sorting options
• 🛡️ Prevent players from purchasing their own listings
• 📬 Offline sale notifications
• 🔊 Fully configurable sounds
• 💬 Fully customizable messages
• 🎨 Hex colors, MiniMessage & legacy color support
• 📑 Permission-based listing limits
• 💾 SQLite storage by default
• 🚀 Built for thousands of listings with excellent performance

🎮 Player Features

• List items with a simple command.

• Browse hundreds or thousands of listings with smooth pagination.

• Search for items using an intuitive Sign GUI or /ah search.

• Sort auctions by:

  • Newest → Oldest
  • Oldest → Newest
  • Cheapest → Most Expensive
  • Most Expensive → Cheapest

• View your active listings.

• Purchase items through a confirmation menu.

• Receive notifications when your items sell—even if you were offline.

🎨 Fully Customizable

Almost everything can be customized without editing the source code.

Configure:

• GUI Titles
• GUI Sizes
• Slot Positions
• Materials
• Custom Model Data
• Custom Items
• Display Names
• Lore
• Sounds
• Messages
• Prefixes
• Menu Layouts
• Click Actions

Design the auction house to perfectly match your server's style.

💰 Economy Support

Compatible with:

• Vault
• CoinsEngine

Switch between supported economy plugins without changing your configuration.

📦 Custom Item Support

Native compatibility with:

• ItemsAdder
• Oraxen
• Nexo
• ExecutableItems

Search, display, and sell custom items seamlessly.

💬 Message System

Every player-facing message is configurable.

Supports:

• Legacy Colors (&)
• Hex Colors (&#RRGGBB)
• MiniMessage
• PlaceholderAPI
• Multi-line Messages
• Automatic Prefixes

🛠️ Admin Features

• Reload configuration
• Remove player listings
• Intelligent tab completion
• Configurable permissions
• Transaction logging
• Easy management tools

🔐 Permissions

Player Permissions

• ozauctions.use — Open the auction house.
• ozauctions.sell — List items for sale.
• ozauctions.search — Search the auction house.
• ozauctions.listings — View your active listings.

Listing Limits

Grant the highest permission to determine the player's maximum active listings.

ozauctions.slot.1
ozauctions.slot.2
...
ozauctions.slot.20

If multiple permissions are granted, the highest value is used (maximum: 20).

Admin Permissions

• ozauctions.admin — Access all administrative commands.
• ozauctions.reload — Reload the plugin configuration.
• ozauctions.remove — Remove player listings.

📋 Commands

Player Commands

/ah
/ah sell <price>
/ah search <query>
/ah listings
/ah help

Admin Commands

/ahadmin reload
/ahadmin remove <player> <item>

📦 Dependencies

Required

• Java 21
• Paper/Spigot 1.16.5+

Supported Economy Plugins

• Vault
• CoinsEngine

Supported Custom Item Plugins

• ItemsAdder
• Oraxen
• Nexo
• ExecutableItems

Optional

• PlaceholderAPI

All supported plugins are detected automatically if installed.

🚀 Performance

ozAuctions is built with scalability in mind.

• Async database operations
• Cached search indexes
• Cached listings
• Efficient pagination
• Minimal main-thread impact
• Optimized for large servers

❤️ Why ozAuctions?

Whether you're running a small community server or a large network, ozAuctions delivers a premium auction experience with powerful customization, excellent performance, and broad compatibility—all while remaining easy to use for both players and administrators.

More features and improvements are planned as development continues, with a focus on stability, performance, and community feedback.