🏪 Best Auction Plugin

A comprehensive and feature-rich auction house plugin for Minecraft Paper/Spigot servers, designed to create vibrant player-driven economies with complete auction functionality. Inspired by popular MMORPG auction systems, this plugin provides a professional-grade trading experience.

✨ Key Features

🏪 Complete Auction System

Item Listing: Sell items with custom starting prices and buy-it-now options
Bidding System: Competitive bidding with automatic price validation
Buy-It-Now: Instant purchase option for immediate transactions
Auction Management: Full control over auction duration and fees
Real-Time Countdown: Live auction end time display

💰 Vault Economy Integration

Universal Economy Support: Works with any Vault-compatible economy plugin
Popular Plugin Compatibility:
- EssentialsX Economy
- iConomy
- BOSEconomy
- MultiCurrency
- GemsEconomy
- PlayerPoints
- TokenEnchant
- And many more!
Automatic Currency Detection: Automatically detects and uses your server's currency
Transaction Security: Safe and reliable money handling with Vault's proven API
Fee System: Configurable listing fees and transaction costs
K/M/B Notation: Large amounts displayed as 1.5K, 2.3M, etc.
Currency Formatting: Respects your economy plugin's formatting settings

📬 Mail System

Automatic Delivery: Items are automatically delivered to winners
Refund System: Automatic refunds for outbid players
Mailbox Interface: Easy access to received items and refunds
Notification System: Real-time updates on auction status

🌐 Multi-Language Support

English & Japanese: Complete localization for both languages
Cultural Adaptation: Proper date formats and number displays
Easy Language Switching: In-game language selection
Extensible System: Easy to add more languages

🔍 Advanced Search & Filtering

Category Search: Browse items by category (weapons, tools, etc.)
Keyword Search: Find specific items quickly
Price Filtering: Search within price ranges
Status Filtering: View active, ended, or your own auctions

☁️ Cloud Integration & REST API

Real-Time Web Interface: View auctions at best-auction-cloud.masafumi-t.workers.dev
REST API: Build your own auction websites and applications
Cross-Server Support: Multiple servers can share auction data
Event Streaming: Real-time auction events via HTTP
Data Synchronization: Automatic backup and sync capabilities

⚙️ Advanced Configuration

Flexible Settings: Customize auction duration, fees, and limits
UI Customization: Adjust display formats and layouts
Debug Controls: Development and testing features
Performance Options: Optimize for your server size

🛠️ Technical Specifications

Requirements

Minecraft: 1.20.1+
Server Type: Paper/Spigot
Java: 17+
Dependencies:
- Vault (Required for economy integration)
- Economy Plugin (EssentialsX, iConomy, etc.)

Architecture

Language: Kotlin 1.9.24
Database: SQLite with Exposed ORM
Build System: Gradle with Kotlin DSL
API: PaperMC 1.20.6
Cloud: Cloudflare Workers integration
Economy: Vault API integration

🎮 Commands

Basic Commands

/ah - Open auction house GUI

/ah sell <price> [buyout] - List item in hand for auction

/ah bid <id> <amount> - Place bid on an item

/ah cancel <id> - Cancel your auction listing

/ah search <keyword> - Search for items

/ah mail - Open mailbox

/ah confirm - Confirm cancellation or buyout

/ah language - Change language settings

/ah help - Show help

Admin Commands

/ah cloud sync [force] - Synchronize data to cloud

/ah cloud status - Show cloud status

/ah cloud validate - Validate API token

/ah cloud gettoken - Get token management URL

/ah cloud settoken <token> - Set cloud API token

/ah testdata [count] - Generate test data (debug mode)

📊 Features Overview

Feature	Description
Auction System	Complete bidding and selling functionality
Vault Integration	Universal economy plugin support
Mail System	Automatic item delivery and refunds
Search	Advanced filtering and search capabilities
Multi-Language	English and Japanese support
Economy Integration	Vault API compatibility
Real-Time Updates	Live countdown and status updates
Cloud Integration	Web interface and REST API
Flexible Configuration	Extensive customization options
Database Storage	Reliable SQLite data persistence

🚀 Installation

Install Vault: Make sure Vault is installed on your server
Install Economy Plugin: Install your preferred economy plugin (EssentialsX, iConomy, etc.)
Download the plugin from CurseForge
Place the JAR file in your plugins/ folder
Restart your server
Configure the plugin in plugins/BestAuction/config.yml
Enjoy your new auction house!

🔧 Configuration Example

Language Settings: language: "en" - Set language (en, ja)

Auction Settings: default_duration: 228 - Auction duration in hours (9.5 days)

listing_fee_rate: 0.05 - Listing fee percentage (5%)

min_listing_fee: 10 - Minimum listing fee

max_listing_fee: 1000 - Maximum listing fee

max_player_listings: 7 - Maximum items per player

Currency Settings (Vault Integration): use_vault_format: true - Use Vault formatting (recommended)

fallback_currency: "gil" - Fallback currency name

currency_symbol: "" - Currency symbol (if not using Vault)

UI Settings: items_per_page: 45 - Items per page

date_format: "yyyy-MM-dd" - Date display format

Cloud Integration: enabled: false - Enable cloud features

base_url: "https://your-worker.your-subdomain.workers.dev" - Cloudflare Workers URL

api_token: "" - Your API token

server_id: "default-server" - Server identifier

💰 Vault Integration Details

Supported Economy Plugins

The plugin works seamlessly with any Vault-compatible economy plugin:

Popular Options:

EssentialsX Economy - Most popular choice
iConomy - Classic economy plugin
BOSEconomy - Bukkit economy
MultiCurrency - Multiple currency support
GemsEconomy - Modern economy solution
PlayerPoints - Points-based economy
TokenEnchant - Token-based economy
ChestShop - Shop-based economy
And many more!

Vault Features

Automatic Detection: No manual configuration needed
Currency Formatting: Respects your economy plugin's settings
Transaction Safety: Uses Vault's secure transaction methods
Balance Checking: Real-time balance validation
Multi-Server Support: Works across multiple servers with shared economy

Economy Plugin Setup

Install Vault first
Install your preferred economy plugin
Configure the economy plugin (EssentialsX, iConomy, etc.)
Install Best Auction Plugin
The plugin will automatically detect and use your economy

☁️ Cloud Integration Setup

Web Interface

Visit best-auction-cloud.masafumi-t.workers.dev to:

View real-time auction data
Browse items across multiple servers
Monitor market trends
Access auction history

REST API

The plugin provides a complete REST API for:

Auction Data: Get current auctions, bids, and history
Event Streaming: Real-time auction events
Data Synchronization: Backup and restore capabilities
Cross-Server Integration: Share auction data between servers

API Endpoints

GET /api/auctions - List all auctions

GET /api/auctions/{id} - Get specific auction

GET /api/servers - List connected servers

POST /api/events - Send auction events

GET /api/sync - Synchronize data

🌟 Why Choose Best Auction Plugin?

Complete Solution

Everything you need for a thriving player economy in one plugin.

Universal Economy Support

Works with any Vault-compatible economy plugin - no vendor lock-in!

Professional Design

Inspired by popular MMORPG auction systems for familiar user experience.

Cloud Integration

Real-time web interface and REST API for modern server management.

User-Friendly

Intuitive GUI designed specifically for Minecraft players.

Highly Configurable

Adapt to any server's needs with extensive configuration options.

Reliable & Secure

Built with modern development practices and comprehensive error handling.

Multi-Language

Perfect for international servers with English and Japanese support.

Active Development

Regular updates and improvements based on community feedback.

📚 Documentation

For detailed setup instructions, configuration options, and troubleshooting, visit our GitHub repository.

🤝 Support

Bug Reports: GitHub Issues
Feature Requests: GitHub Discussions
Documentation: Plugin Documentation
Web Interface: best-auction-cloud.masafumi-t.workers.dev

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

This plugin was developed with the assistance of Claude Code, showcasing the power of AI-assisted development in creating high-quality Minecraft plugins.

Transform your Minecraft server's economy with the most comprehensive auction house plugin available, featuring universal Vault integration and cloud API support!