PlayTimePulse

<h2> New Features</h2> <h3> Real-time Tracking</h3> <ul> <li><strong>Second-by-Second Updates</strong> – Playtime now updates every second instead of every minute for ultra-precise tracking</li> <li><strong>Enhanced Accuracy</strong> – More accurate playtime measurement for fair reward distribution</li> </ul> <h3> Leaderboard Support</h3> <ul> <li><strong>Top Player Placeholders</strong> – Added placeholders for top 10 players (<code>%playtime_top_1%</code> through <code>%playtime_top_10%</code>)</li> <li><strong>Player Position Placeholder</strong> – Added <code>%playtime_leaderboard_position%</code> to show a player's rank</li> <li><strong>Real-time Updates</strong> – Leaderboard updates every second with playtime tracking</li> </ul> <h3> Admin Tools</h3> <ul> <li><strong>Reload Command</strong> – Added <code>/playtime reload</code> command for administrators to reload configuration without restarting the server</li> <li><strong>Debug Mode</strong> – Added debug mode with detailed logging for troubleshooting <ul> <li>Enable with <code>debug: true</code> in <code>config.yml</code></li> <li>Toggle with <code>/playtime debug [true/false]</code> command</li> <li>Shows detailed information about reward processing and configuration loading</li> </ul> </li> </ul> <h3> Multi-Language Support</h3> <ul> <li><strong>8 Languages Supported</strong>: <ul> <li> English (<code>en</code>) – Default language</li> <li> Chinese (<code>zh</code>)</li> <li> Brazilian Portuguese (<code>pt_BR</code>)</li> <li> Russian (<code>ru</code>)</li> <li> Filipino (<code>fil</code>)</li> <li> German (<code>de</code>)</li> <li> French (<code>fr</code>)</li> <li> Finnish (<code>fi</code>)</li> </ul> </li> <li><strong>Language Configuration</strong>: <ul> <li>Set language with <code>language: [code]</code> in <code>config.yml</code></li> <li>Language files automatically copied to plugin directory for customization</li> <li>Fallback system: Language files → config translations → default English</li> </ul> </li> </ul> <h2> Improvements</h2> <h3> Playtime Tracking</h3> <ul> <li><strong>Second Precision</strong> – All time displays now include seconds for more precise information</li> <li><strong>Command Enhancements</strong> – <code>/playtime add</code> command now supports seconds parameter (<code>/playtime add &lt;player&gt; &lt;hours&gt;h [&lt;minutes&gt;m] [&lt;seconds&gt;s]</code>)</li> </ul> <h3> Configuration</h3> <ul> <li><strong>Reduced Console Spam</strong> – Most INFO logs now only appear in debug mode</li> <li><strong>Better Error Handling</strong> – Improved error messages and warnings for configuration issues</li> <li><strong>Language Settings</strong> – Added <code>language</code> option in <code>config.yml</code></li> <li><strong>Lore Placeholder Support</strong> – Added support for PlaceholderAPI placeholders in reward item lore</li> </ul> <h3> Commands</h3> <ul> <li><strong>Tab Completion</strong> – Added tab completion support for all commands</li> <li><strong>Permission Checks</strong> – Enhanced permission validation for admin commands</li> <li><strong>Seconds Support</strong> – Added seconds parameter support to <code>/playtime add</code> command</li> </ul> <h3> Logging</h3> <ul> <li><strong>Conditional Logging</strong> – Most verbose logs now only appear when debug mode is enabled</li> <li><strong>Cleaner Console</strong> – Reduced unnecessary INFO messages in normal operation</li> <li><strong>Debug Mode</strong> – Detailed logging available for troubleshooting configuration issues</li> </ul> <h3> Placeholders</h3> <ul> <li><strong>Comprehensive Documentation</strong> – Added detailed section in README for all PlaceholderAPI placeholders</li> <li><strong>Advanced Reward Placeholders</strong> – Documented placeholders for reward status tracking</li> <li><strong>Leaderboard Placeholders</strong> – Added new leaderboard placeholders for top players and player positions</li> <li><strong>Usage Examples</strong> – Added practical examples for using placeholders in various contexts</li> </ul> <h2> Bug Fixes</h2> <ul> <li><strong>Configuration Validation</strong> – Fixed potential NullPointerExceptions in configuration loading</li> <li><strong>Reward Processing</strong> – Improved error handling when loading rewards</li> <li><strong>Language Loading</strong> – Fixed issues with loading translation files</li> <li><strong>Placeholder Logic</strong> – Improved logic for determining next reward in progression</li> </ul> <h2> Documentation</h2> <ul> <li><strong>README Updates</strong> – Comprehensive documentation of new features</li> <li><strong>Command List</strong> – Added new admin commands to command table</li> <li><strong>Configuration Guide</strong> – Updated configuration documentation with language settings</li> <li><strong>Installation Guide</strong> – Improved installation instructions</li> <li><strong>PlaceholderAPI Support</strong> – Added comprehensive section with all placeholders and usage examples</li> <li><strong>Leaderboard Documentation</strong> – Added documentation for new leaderboard placeholders</li> </ul> <h2> For Server Owners</h2> <h3> New Commands</h3> <pre><code>/playtime reload - Reload plugin configuration /playtime debug [true/false] - Toggle debug mode </code></pre> <h3> Configuration Changes</h3> <pre><code class="language-yaml"># New debug setting debug: false

New language setting

language: en # Supports: en, zh, pt_BR, ru, fil, de, fr, fi </code></pre> <h3> Language Customization</h3> <ol> <li>After first run, language files are copied to <code>plugins/PlayTimePulse/lang/</code></li> <li>Edit the file for your selected language</li> <li>Use <code>/playtime reload</code> to apply changes without restarting</li> </ol> <h3> Debug Mode</h3> <p>Enable detailed logging for troubleshooting:</p> <pre><code class="language-yaml">debug: true </code></pre> <p>Or use the command:</p> <pre><code>/playtime debug true # Enable debug mode /playtime debug false # Disable debug mode /playtime debug # Check current debug mode status </code></pre> <h3> PlaceholderAPI Placeholders</h3> <p><strong>Basic Placeholders</strong>:</p> <ul> <li>%playtime_overall_formatted% – Total formatted playtime</li> <li>%playtime_days%, %playtime_hours%, etc. – Time components</li> </ul> <p><strong>Advanced Reward Placeholders</strong>:</p> <ul> <li>%playtime_required% – Time for next unclaimed reward</li> <li>%playtime_required_{rewardId}% – Status of specific reward</li> <li>%playtime_time_left_{rewardId}% – Time left for specific reward</li> <li>%playtime_claimable_rewards% – Number of claimable rewards</li> </ul> <p><strong>Leaderboard Placeholders</strong>:</p> <ul> <li>%playtime_top_1% through %playtime_top_10% – Top players in playtime</li> <li>%playtime_leaderboard_position% – Player's position in leaderboard</li> </ul> <p>See README for complete list and usage examples.</p> <h2> Previous Versions</h2> <p><em>For changelog of previous versions, see GitHub releases.</em></p>

Page Logic Just Got Smarter! What’s New: • Detects bad indentation in rewards config • “More Rewards Coming Soon” on last page • Clearer, friendlier error messages Why It’s Cool: No more mystery bugs! Get helpful console hints to fix issues fast. Setup is smoother than ever! To Update: Just replace your current .jar with this one and restart your server!

PlayTimePulse v1.0.2 - The Epic Upgrade

Highlights

- Complete Rebranding: PlayTimeTracker evolves into PlayTimePulse - Immersive Sound System: Custom sounds for each reward tier - Enhanced Admin Tools: New commands for better server management - Performance Optimization: Better resource handling and bug fixes

Major Changes

Core Updates

- Rebranded to PlayTimePulse - a more dynamic and engaging name - Integrated bStats for anonymous usage insights (ID: 26638) - Optimized data handling and storage systems - Enhanced thread safety across all operations

New Sound System

- Custom sound effects for reward claims - Support for 400+ Minecraft sounds - Per-reward sound configuration - Default sound: entity.player.levelup - Volume and pitch consistency (1.0)

Command Enhancements

#### New Admin Commands: /playtime add <player> h [m] # Add playtime /playtime reset <player> # Reset progress #### Features: - Smart tab completion - Sound feedback for actions - Detailed error messages - Permission-based access

Technical Improvements

- Updated to Java 21 - Optimized dependency management - Reduced plugin size - Enhanced error handling - Improved memory management

Statistics Integration

- Anonymous usage tracking via bStats - Opt-out available in bStats config - Performance impact monitoring - Usage pattern analysis

Documentation

- Updated documentation for new features - Enhanced configuration examples - Comprehensive sound setup guide - Clear command usage instructions

Bug Fixes

- Fixed memory leaks in playtime tracking - Improved sound effect error handling - Enhanced data saving thread safety - Better error reporting

Installation

1. Drop PlayTimePulse.jar into plugins folder 2. Restart server 3. Configure as needed 4. Previous data automatically migrates

Permissions

- playtime.use: Basic access (default: true) - playtime.admin: Admin commands (default: op)

What's New

- Full support for Minecraft 1.21.8 - Integrated support for Minecraft-Heads.com (see config)

Added more preconfigured rewards!