PlayerAuctions

Version 3.1.0 (February 25, 2026)

Added

• Mailbox Integration for Auctions: Items and revenues are now safely routed through the Mailbox system!
  • Cancelled Auctions: Instead of forcefully dropping returned items on the ground or cluttering the inventory, cancelling an auction now instantly sends the item to the Mailbox for asynchronous retrieval.
  • Auction Sales: When an item is bought, the revenue is sent to the seller's Mailbox as a distinct money notification instead of spontaneously appearing in the player's balance. Claiming the money notification within the Mailbox deposits the balance seamlessly and serves as a read receipt for the transaction.

Version 3.0.0 (February 25, 2026)

Major Changes

• Migrated to Cloud Command Framework (CCF): Rebuilt the entire command system for robust and native Paper command execution, including dynamic tab completions and strict argument parsing.
• Removed Legacy Support: Discontinued support for Minecraft versions 1.18 to 1.20 to fully standardize compatibility and features with the latest Paper 1.21 API.
• Modernized GUI Formatting: Fully integrated the Adventure Component API and MiniMessage formatting internally.

Fixed

• Fixed MiniMessage and Gradient Parsing Issues: Resolved bugs where MiniMessage and Hex gradients were explicitly stripped down to legacy ampersands, destroying formats in GUIs.
• Removed Default Minecraft Italicization: Removed forced default italics on GUI item names and lores across all PlayerAuctions menus. Let your configurations shine!
• Fixed My Listings GUI Blank Page Bug: Fixed a misapplied SQL offset argument that caused active items from an individual player to not load correctly within the player's personal listings interface.
• Resolved NoSuchMethodError for native component formatting caused by old Maven shade relocations on the Adventure API.
• Re-implemented the missing MiniMessage tag checking regex inside MessageParser to accurately detect Hex tags natively.

Added - Broadcast Notifications System

• Global Broadcast Notifications for auction events

  • Broadcast when players list items for auction
  • Broadcast when players purchase items
  • Clickable "View Auction" link in listing broadcasts
  • Beautiful hex-colored messages with emojis

• BroadcastManager Service

  • Centralized broadcast management
  • Configurable broadcast ranges (GLOBAL, WORLD, NONE)
  • Individual toggles for listing and purchase broadcasts
  • Smart player name resolution for offline sellers
  • World-based broadcasting support

Configuration Options

auction:
  broadcast:
    enabled: true           # Master toggle
    on-listing: true        # Broadcast new listings
    on-purchase: true       # Broadcast purchases
    range: GLOBAL          # GLOBAL, WORLD, or NONE

Broadcast Messages

• Item Listed: Shows player, item name, quantity, and price with clickable link
• Item Purchased: Shows buyer, seller, item, quantity, and price

Technical Implementation

• Integrated BroadcastManager into PlayerAuction main class
• Broadcasts triggered from AuctionCommand (/ah sell)
• Broadcasts triggered from AuctionService (purchase completion)
• MiniMessage support for rich text formatting
• Click events for interactive messages
• Proper thread handling (main thread for Bukkit operations)

Benefits

• Server Activity: Players see active marketplace
• Price Discovery: Players learn market prices
• Engagement: Encourages trading and competition
• Transparency: All trades are visible to community
• Configurable: Can disable per feature or globally

---

Fixed

• Fixed NullPointerException in ConfigManager.getMessage()

  • Added null check for replacements parameter to prevent crashes
  • Now handles calls with null varargs gracefully
  • Fixes GUI opening errors in MainAuctionGui and MailboxGui

• Fixed file I/O errors in JsonAuctionStorage

  • Implemented retry logic with 3 attempts for file rename operations
  • Added automatic old file deletion before rename to prevent conflicts
  • Improved error logging with detailed diagnostics
  • Reduced "Failed to rename temporary file" errors significantly

• Fixed ResourceLocationException for notification sounds

  • Implemented smart sound name handling (supports both enum and resource location formats)
  • Added automatic format conversion from enum names to resource locations
  • Added fallback to safe default sound (ENTITY_EXPERIENCE_ORB_PICKUP) if playback fails
  • Prevents crashes from malformed sound names like "BLOCK_NOTE_BLOCK_PLING"

Removed

• Removed search feature from auction house menu
  • Deleted SearchManager class and all search-related functionality
  • Removed search button from /ah GUI (slot 48 now empty)
  • Removed search query parameter from auction methods
  • Cleaned up search-related messages from messages.yml
  • Removed playerauctions.search permission from plugin.yml

v2.5.2 - Critical Security & Stability Update

🛡️ CRITICAL SECURITY FIX

Patched Double Purchase Item Duplication Exploit

Fixed a critical vulnerability where multiple players could purchase the same auction item simultaneously, allowing item duplication and economic exploitation.

What Was Fixed:

• Multi-purchase exploit: Players could spam-click to buy the same auction item
• Seller overpayment: Sellers received multiple payments for a single item
• Item duplication: Buyers could duplicate items through concurrent purchases
• Economic instability: Server economy could be unfairly manipulated

Technical Changes:

• Implemented Atomic Reservation Pattern - items are reserved before currency transfer
• Added Optimistic Locking - prevents concurrent purchases with version checking
• Enhanced Automatic Rollback - auctions revert to ACTIVE status if transactions fail
• Improved Thread-Safe Operations - inventory operations moved to main thread
• Added Clear Error Feedback - users receive explicit messages for failed purchases

Update Recommendation: ⚠️ IMMEDIATE UPDATE REQUIRED - This fix addresses a severe game-breaking exploit.