# 🛠 Version 1.0.5-SNAPSHOT – Customization Update ### ✨ Additions - **Config:** `disable-default-reward-information` — full customization of reward text. - **Rewards:** Added vanilla Minecraft rewards for levels **20–23** (no external plugin dependencies). ### 🐛 Fixes - Fixed page navigation bug that blocked access to multi-page rewards. - Corrected *"More Rewards Coming Soon"* item display behavior. ### ⚙️ Changes - Removed unnecessary `clear-default-rewards` configuration parameter. - Corrected YAML formatting in the default config. - Enhanced vanilla Minecraft compatibility using only standard items and commands. **Summary:** This update gives server administrators **complete control** over how reward information is displayed to players while fixing a critical navigation issue that prevented access to rewards on subsequent pages.

<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! 🔧

-version with fixed excessive logs

Version with fixed config

## 🎉 PlayTimePulse v1.0.3 – Major Update! 🚀 Reward your players' time like never before with **PlayTimePulse** ⏰✨ This update brings major improvements to performance, customization, and user experience. --- ### 🌟 **Key Improvements** #### 🎮 Core Features - 📖 **Pageable GUI** – Effortlessly browse **24+ rewards** with a clean, scrollable interface - ⚙️ **Flexible Config** – Tailor everything from layout to rewards, sounds, and visuals - 🛡️ **Enhanced Stability** – Robust systems prevent common errors and ensure smooth operation #### 🚫 Error Handling - ✅ Automatically blocks **reward spamming** and double-claiming - 🧠 Intelligent checks to ensure fair reward distribution #### ⚡ Performance - 💨 **Lightweight & optimized** – Designed for high-efficiency with minimal server impact --- ### 🎨 **User Experience** - 🖱️ **Intuitive GUI Navigation** – Fully configurable navigation buttons and layout - 🎵 **Sound Feedback** – Each reward can trigger its **own unique sound effect** --- ### 🔒 **Protection & Fairness** - 🛑 **AFK Detection** – Optional system to **block idle farming** - 📊 **Activity Tracking** – Rewards real playtime and **in-game actions**, not just login time --- 💡 Reward your players' time with PlayTimePulse! ⏰✨

# 🎮 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!

Fixed first item issue.