🐝 BeeAuction

BeeAuction is a powerful, modern, and robust auction plugin designed for Minecraft servers that want to create a dynamic and engaging economy. Run global auctions for items or command rewards, create exciting scheduled events, and give your players a seamless and professional auction experience.

This plugin is built for performance and compatibility, ensuring it works flawlessly with modern server software and dependencies.

✨ Features

• Dual Auction System » Auction physical items (including custom items from Nexo/ItemsAdder) or virtual rewards like permissions, money, or special effects via commands.
• Automated Scheduled Auctions » Keep your community engaged by setting up a fully automated schedule of auctions for specific days and times. Configure a whole week of events in advance!
• Robust Offline Handling » A player doesn't have to be online to win! The new /claim system securely stores items for offline players, notifying them on their next login. No more lost winnings or returned items.
• Smart Bidding System » Bidding is intuitive and fair. Auctions automatically extend their time when a bid is placed in the final moments, preventing "bid sniping" and creating thrilling final seconds.
• Intelligent Admin Workflow » Starting an auction is now an interactive, timeout-protected process. Admins are guided through setup via chat and can safely cancel at any time.
• Modern Economy Integration » Full support for both the original Vault and modern forks like Vault Unlocked.
• Configurable Economy Sinks » Implement a server-wide sales tax or a minimum bid increment to help manage your server's economy.
• Live Update Notifications » Admins are automatically notified in-game when a new version of BeeAuction is available on Modrinth, with a direct link to the download page.
• Persistent & Lightweight » Uses a local SQLite database to store all auction history and pending claims, requiring no external database setup.
• Fully Customizable » Every message, command name, and setting can be tailored to match your server's theme and language.

📥 Installation

1. Place the BeeAuction.jar file in your server’s plugins folder.
2. Install an economy provider. Vault (or a fork like Vault Unlocked) is required.
3. Ensure you have an economy plugin that hooks into Vault (e.g., EssentialsX, CMI, TheNewEconomy).
4. Restart your server.
5. Customize the generated configuration files in the /plugins/BeeAuction/ folder to your liking.

⚙️ Commands

Admin Commands (beeauction.admin)

Player Commands (beeauction.bid)

🗂️ Configuration

BeeAuction is highly configurable. Below is the default config.yml with explanations for the new features.

###################################
#                                 #
#    BeeAuction Configuration     #
#    By: BusyBee Development      #
###################################

#---------------------------------
# Auction Configuration
#---------------------------------
auction:
  # Time in seconds to add to the auction when a bid is placed near the end.
  bid-time-extension: 30
  # Time threshold in seconds. The extension is only added if the remaining time is BELOW this value.
  bid-time-threshold: 60
  # The absolute minimum a player can bid to start an auction.
  min-bid-amount: 100
  # NEW: The minimum amount by which a new bid must exceed the current bid.
  # Example: If current bid is 1000 and this is 10, the next bid must be at least 1010.
  min-bid-increment: 10
  # NEW: The tax rate (e.g., 0.05 = 5%) to take from the final sale price of player-started auctions.
  # The seller receives the final price minus this tax. Set to 0 to disable.
  sales-tax-rate: 0.05

#---------------------------------
# Storage Configuration
#---------------------------------
storage:
  # Currently only SQLITE is supported.
  type: SQLITE

#---------------------------------
# Commands Configuration
#---------------------------------
commands:
  admin:
    name: "auction"
    aliases: ["ba", "ah"]
    subcommands:
      start: "start"
      cancel: "cancel"
      reload: "reload"
    auction-types:
      item: "item"
      command: "command"
  player:
    bid: "bid"
    bid-aliases: []

#---------------------------------
# Scheduled Auctions Configuration
#---------------------------------
schedule:
  # Enable or disable scheduled auctions that run automatically.
  enabled: true
  auctions:
    # Example Item Auction
    - day: MONDAY
      time: "20:00" # 24-hour format (HH:mm)
      name: "&bSpecial Diamonds Auction"
      reward:
        type: ITEM
        start_price: 500
        item:
          material: DIAMOND
          amount: 3
          name: "&bSpecial Diamonds"
          lore:
            - "&7These diamonds were won in an auction."

    # Example Command Auction
    - day: THURSDAY
      time: "20:30"
      name: "&cStrength Effect Auction"
      reward:
        type: COMMAND
        start_price: 250
        command: "effect give %player% strength 300 1"
        # NEW: Use 'display-name' to show a clean name for the command reward.
        display-name: "&cStrength II Potion (5:00)"