PlayTimePulse icon

PlayTimePulse -----

Reward your players' time with PlayTimePulse! ⏰✨



Version 1.0.4
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
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