Download File

# 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!** 🚀✨