PlayTimePulse icon

PlayTimePulse -----

Reward your players' time with PlayTimePulse! ⏰✨




# Spigot Plugin Changelog

## Version 1.0.5-SNAPSHOT – Major Feature Update

### ✨ New Features
- **Config:** `disable-default-reward-information` — set to `true` to hide default status/progress text on rewards, allowing full customization via lore.
- **Rewards:** Updated levels **20–23** with default Minecraft rewards:
- Enchanted Golden Apples
- ️ Totems of Undying
- Mending Books
*No external plugins required!*

### Bug Fixes
- **Navigation:** Fixed critical bug that prevented users from accessing rewards on subsequent pages.
- **UI:** Resolved issue with *"More Rewards Coming Soon"* item displaying incorrectly when rewards were available.

### Improvements
- Removed unnecessary `clear-default-rewards` configuration parameter.
- Fixed YAML formatting issues in the default config.
- Enhanced compatibility with vanilla Minecraft servers.

**Summary:**
This update gives server owners **full control** over reward display and fixes a major navigation issue. Reward item descriptions can now be completely customized through the config file.
----------, Aug 13, 2025

New Features

⏱️ Real-time Tracking
  • Second-by-Second Updates - Playtime now updates every second instead of every minute for ultra-precise tracking
  • Enhanced Accuracy - More accurate playtime measurement for fair reward distribution

Leaderboard Support
  • Top Player Placeholders - Added placeholders for top 10 players (`%playtime_top_1%` through `%playtime_top_10%`)
  • Player Position Placeholder - Added `%playtime_leaderboard_position%` to show a player's rank
  • Real-time Updates - Leaderboard updates every second with playtime tracking

Admin Tools
  • Reload Command - Added `/playtime reload` command for administrators to reload configuration without restarting the server
  • Debug Mode - Added debug mode with detailed logging for troubleshooting
    • Enable with `debug: true` in config.yml
    • Toggle with `/playtime debug [true/false]` command
    • Shows detailed information about reward processing and configuration loading

Multi-Language Support
  • 8 Languages Supported:
    • English (`en`) - Default language
    • Chinese (`zh`)
    • Brazilian Portuguese (`pt_BR`)
    • Russian (`ru`)
    • Filipino (`fil`)
    • German (`de`)
    • French (`fr`)
    • Finnish (`fi`)
  • Language Configuration:
    • Set language with `language:
      Code (Text):
      ` in config.yml
      [*]Language files automatically copied to plugin directory for customization
      [*]Fallback system: Language files → config translations → default English
      [/list]
      [/list]


      [size=150][b]️ Improvements[/b][/size]

      [size=125][b]⏱️ Playtime Tracking[/b][/size]
      [list]
      [*][b]Second Precision[/b] - All time displays now include seconds for more precise information
      [*][b]Command Enhancements[/b] - `/playtime add` command now supports seconds parameter (`/playtime add <player> <hours>h [<minutes>m] [<seconds>s]`)
      [/list]

      [size=125][b] Configuration[/b][/size]
      [list]
      [*][b]Reduced Console Spam[/b] - Most INFO logs now only appear in debug mode
      [*][b]Better Error Handling[/b] - Improved error messages and warnings for configuration issues
      [*][b]Language Settings[/b] - Added `language` option in config.yml
      [*][b]Lore Placeholder Support[/b] - Added support for PlaceholderAPI placeholders in reward item lore
      [/list]

      [size=125][b] Commands[/b][/size]
      [list]
      [*][b]Tab Completion[/b] - Added tab completion support for all commands
      [*][b]Permission Checks[/b] - Enhanced permission validation for admin commands
      [*][b]Seconds Support[/b] - Added seconds parameter support to `/playtime add` command
      [/list]

      [size=125][b] Logging[/b][/size]
      [list]
      [*][b]Conditional Logging[/b] - Most verbose logs now only appear when debug mode is enabled
      [*][b]Cleaner Console[/b] - Reduced unnecessary INFO messages in normal operation
      [*][b]Debug Mode[/b] - Detailed logging available for troubleshooting configuration issues
      [/list]

      [size=125][b] Placeholders[/b][/size]
      [list]
      [*][b]Comprehensive Documentation[/b] - Added detailed section in README for all PlaceholderAPI placeholders
      [*][b]Advanced Reward Placeholders[/b] - Documented placeholders for reward status tracking
      [*][b]Leaderboard Placeholders[/b] - Added new leaderboard placeholders for top players and player positions
      [*][b]Usage Examples[/b] - Added practical examples for using placeholders in various contexts
      [/list]


      [size=150][b] Bug Fixes[/b][/size]
      [list]
      [*][b]Configuration Validation[/b] - Fixed potential NullPointerExceptions in configuration loading
      [*][b]Reward Processing[/b] - Improved error handling when loading rewards
      [*][b]Language Loading[/b] - Fixed issues with loading translation files
      [*][b]Placeholder Logic[/b] - Improved logic for determining next reward in progression
      [/list]


      [size=150][b] Documentation[/b][/size]
      [list]
      [*][b]README Updates[/b] - Comprehensive documentation of new features
      [*][b]Command List[/b] - Added new admin commands to command table
      [*][b]Configuration Guide[/b] - Updated configuration documentation with language settings
      [*][b]Installation Guide[/b] - Improved installation instructions
      [*][b]PlaceholderAPI Support[/b] - Added comprehensive section with all placeholders and usage examples
      [*][b]Leaderboard Documentation[/b] - Added documentation for new leaderboard placeholders
      [/list]


      [size=150][b] For Server Owners[/b][/size]

      [size=125][b]✨ New Commands[/b][/size]
      [code]
      /playtime reload              - Reload plugin configuration
      /playtime debug [true/false]  - Toggle debug mode
       
      ⚙️ Configuration Changes
      Code (YAML):

      # New debug setting
      debug
      : false

      # New language setting
      language
      : en   # Supports: en, zh, pt_BR, ru, fil, de, fr, fi
       
      Language Customization
      1. After first run, language files are copied to `plugins/PlayTimePulse/lang/`
      2. Edit the file for your selected language
      3. Use `/playtime reload` to apply changes without restarting

      Debug Mode
      Enable detailed logging for troubleshooting:
      Code (YAML):

      debug
      : true
       
      Or use the command:
      Code (Text):

      /playtime debug true    # Enable debug mode
      /playtime debug false   # Disable debug mode
      /playtime debug         # Check current debug mode status
       
      PlaceholderAPI Placeholders

      Basic Placeholders:
      • %playtime_overall_formatted% - Total formatted playtime
      • %playtime_days%, %playtime_hours%, etc. - Time components

      Advanced Reward Placeholders:
      • %playtime_required% - Time for next unclaimed reward
      • %playtime_required_{rewardId}% - Status of specific reward
      • %playtime_time_left_{rewardId}% - Time left for specific reward
      • %playtime_claimable_rewards% - Number of claimable rewards

      Leaderboard Placeholders:
      • %playtime_top_1% through %playtime_top_10% - Top players in playtime
      • %playtime_leaderboard_position% - Player's position in leaderboard

      See README for complete list and usage examples.


      Previous Versions
      For changelog of previous versions, see GitHub releases.
----------, Aug 8, 2025

Smarter Page Logic (New in 1.0.3)
  • Config error detection (indentation & structure)

  • “More Rewards Coming Soon” item on last page

  • Clear console messages to help fix issues fast
Update by replacing your current .jar and restarting the server
----------, Jul 31, 2025

Removed excessive logging of another inventory!
----------, Jul 31, 2025

Minor config lore fix
----------, Jul 31, 2025

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
  • ✅ Blocks reward spamming and double-claiming
  • Smart checks for fair distribution

⚡ Performance
  • Lightweight & optimized – Minimal impact even on busy servers

---

User Experience

  • Intuitive GUI Navigation – Fully customizable buttons and layout
  • Sound Feedback – Add unique effects to each reward

---

Protection & Fairness

  • AFK Detection – Optional anti-idle farming system
  • Activity Tracking – Rewards only real gameplay, not just online time



Reward your players' time with PlayTimePulse! ⏰✨
----------, Jul 30, 2025

-Added sounds (configurable as well)
-Bstats
-Commands for resetting and adding playtime!
----------, Jul 24, 2025

Now compatible with Minecraft 1.21.8!
Minecraft-heads support – easily access thousands of custom heads for your rewards or gui decorations!
----------, Jul 20, 2025

Preconfig changes + titles for each reward, item slots are configurable
ToDo: Make overall GUI slots / layout more configurable too
----------, Jul 13, 2025

-First item coudn't be claimed cause of NBT support
ToDo: NBT Support
----------, Jul 13, 2025

Resource Information
Author:
----------
Total Downloads: 237
First Release: Jul 12, 2025
Last Update: Aug 13, 2025
Category: ---------------
All-Time Rating:
0 ratings
Find more info at github.com...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings