⚔️ Best Auction 🛡️

Complete Documentation

🌟 Overview

Welcome to Best Auction

A comprehensive auction house plugin for Minecraft servers

🎮 For Players

  • List items for auction or instant sale
  • Bid on items from other players
  • Search and filter by categories
  • Receive items via mailbox system

🛠️ For Administrators

  • Cloud integration for web interface
  • Detailed configuration options
  • Performance monitoring
  • Multi-server support

📚 User Guide

📜 Basic Commands

Open Auction House

/auction or /ah

Opens the main auction house GUI

Sell Item

/auction sell <price> [buyout]

List item in your hand

Place Bid

/auction bid <id> <amount>

Bid on an auction item

Cancel Listing

/auction cancel <id>

Cancel your auction listing

Open Mailbox

/auction mail

Receive items and refunds

Search Items

/auction search <keyword>

Search for specific items

📤 How to List Items

GUI Method

  1. Open auction house with /ah
  2. Click the emerald block at bottom center
  3. Place item in the empty slot
  4. Enter starting price in chat
  5. Optionally enter buyout price
  6. Confirm the listing

Command Method

Hold item in main hand:

  • /ah sell 1000 - List for 1000G (auction only)
  • /ah sell 1000 5000 - List with 5000G buyout

💰 Fees & Restrictions

Fee Structure

  • Listing Fee: 5% (min 10G, max 1000G)
  • Sales Tax: 3% of final price
  • Duration: 228 hours (9.5 days)

Restrictions

  • Max 7 items listed per player
  • Items must be 1 or full stack
  • No damaged items

🏆 Bidding System

  • Left-click item to view details
  • Right-click to place bid
  • Minimum increment: 10% of current price
  • Money deducted immediately
  • Refunded if outbid via mailbox

📬 Mailbox System

Access with /auction mail

  • 🟢 Green wool - Ready to collect
  • 🔴 Red wool - Need inventory space
  • Max 50 mails per player
  • Auto-deleted after 30 days

🛠️ Administrator Guide

🌐 Cloud Integration

Best Auction Cloud

Web interface for viewing auctions across servers

URL: https://best-auction-cloud.masafumi-t.workers.dev/

⚙️ Setup Steps

1. Get API Token

  1. Run /auction cloud gettoken
  2. Visit the provided URL
  3. Create account and copy token

2. Configure Server

/auction cloud settoken YOUR_TOKEN

Or edit config.yml:

cloud:
  enabled: true
  api_token: "YOUR_TOKEN"
  server_id: "server-name"

3. Verify & Sync

  • /auction cloud validate - Check token
  • /auction cloud status - View status
  • /auction cloud sync - Manual sync

🔧 Admin Commands

Cloud Status

/auction cloud status

Show connection status

Force Sync

/auction cloud sync force

Full data resync

Dashboard

/auction cloud dashboard

Get web dashboard URL

📊 Configuration

Key Settings

auction:
  default_duration: 228        # Hours
  listing_fee_rate: 0.05      # 5%
  tax_rate: 0.03              # 3%
  max_player_listings: 7      # Per player
  
cloud:
  batch_size: 50              # Items per sync
  batch_delay: 1000           # Milliseconds

🛡️ Privacy & Security

Data Shared with Cloud

  • ✅ Item names, prices, seller names
  • ✅ Auction timestamps
  • ❌ Player UUIDs (anonymized)
  • ❌ IP addresses
  • ❌ Server configuration