PlayerAuctions Changelog - v2.4.0

Release Date: January 25, 2026
Build: PlayerAuctions-2.4.0-Modern.jar
Status: ✅ Production Ready
Compatibility: Minecraft 1.19 - 1.21; Java 21; Paper API 1.21.8

📋 Summary

• Version 2.4.0 adds complete information to auctioned items in /ah, including starting bid, current bid, buy now price, reserve price, bid count & highest bidder, listed date & time remaining, and item quantity.
• Impact: Enhances transparency and player engagement in auctions by providing detailed stats at a glance, reducing guesswork.

✨ New Features

• Complete Auction Statistics in Item Lore:

  • Expanded lore display with sections for pricing (start bid, current bid, buy now, reserve), stats (total bids, highest bidder), time (listed date, ends in, duration), and status.
  • Before: Basic seller, price, ends in, and status.
  • After: Structured with dividers, colors, and small caps for a professional look (e.g., "ᴘʀɪᴄɪɴɢ" headers).
  • Impact: Makes auctions more informative, helping players make better bids.

• New Placeholders:

  • Added 17 placeholders for dynamic data, e.g., {seller}, {quantity}, {starting_price}, {buy_now_display} (with color), {bid_count}, {listed_date}, {time_left} with urgency color, and {needed_amount}.
  • Examples: {time_color} uses hex based on time left; {status_color} for visual cues.
  • Impact: Enables customizable messaging in configs, preparing for future bid systems.

• Time Color Coding:

  • Colors based on remaining time: Emerald (#2ECC71) for >24h (plenty), Carrot (#E67E22) for 1-24h (warning), Coral Red (#E74C3C) for <1h or expired (urgent).
  • Impact: Provides intuitive visual urgency, improving user awareness without reading full text.

• Context-Aware Action Buttons:

  • For others' auctions: "Buy Now / Place Bid" if affordable; "Insufficient Funds" with needed amount if not.
  • For own auctions: "Your Auction - Click to manage".
  • Impact: Reduces errors (e.g., failed buys) and streamlines interactions with conditional prompts.

📁 Files Changed and Implementation

• messages.yml:

  • Updated gui.item-lore with full stats template using hex colors and placeholders.
  • Added gui.item-action for conditional buttons (can-purchase, insufficient-funds, own-auction).

• MainAuctionGui.java:

  • Added placeholder context, time color coding, own-auction detection, needed_amount calc, and listed_date formatting (~80 lines changed).

• MyListingsGui.java:

  • Aligned with main GUI: Same placeholders, time coding, formatItemName helper, and hex status (~60 lines changed).

• Other: pom.xml and plugin.yml updated to v2.4.0 (~30 lines in messages.yml).

• Total: 4 files modified; New placeholders: 17; Build size: ~3.83 MB.

✅ Testing and Deployment Notes

• Testing Checklist Summary: Verified seller/quantity/pricing/bids/time/status displays; action buttons for afford/own cases; my listings consistency.
• Deployment Steps: Stop server, backup/delete old messages.yml (config changed), install new JAR, start, verify with /version PlayerAuctions.
• Future Prep: Placeholders like {current_bid} and {bid_count} ready for upcoming bid tracking.
• No breaking changes beyond config updates—report issues on GitHub.

PlayerAuctions v2.4.0 - Complete Auction Statistics is ready! 🚀✨