TimeTracker icon

TimeTracker -----

Simple playtime tracking. No database, no hassle.




⏱ TimeTracker
Track and display player playtime on your server


Description

TimeTracker is a lightweight Paper plugin that reads Minecraft's native statistics to track and display how long each player has been on the server. No external databases, no extra configuration — it works out of the
box.


✨ Features


  • Shows playtime in days, hours and minutes
  • Paginated top ranking with 5 players per page, including offline players
  • Players with less than 1 minute of playtime are automatically excluded from the ranking
  • Permanently remove or restore players from the top ranking
  • Reload the config without restarting the server
  • Fully customizable messages, colors and format via config.yml
  • Exclusions persist across restarts

Commands

Code (Text):
                                                                                                         
  /playtime                        - Broadcasts your total playtime to all players                                                                                                                                              
  /timetop [page]                  - Shows the playtime ranking (offline included)                                                                                                                                              
  /timetracker help                - Shows all available commands                                                                                                                                                              
  /timetracker reload              - [OP] Reloads config.yml                                                                                                                                                                    
  /timetracker remove <player>     - [OP] Removes a player from the ranking permanently                                                                                                                                        
  /timetracker restore <player>    - [OP] Restores a removed player to the ranking                                                                                                                                              
 

⚙️ Configuration

The config.yml is generated automatically on first start inside plugins/TimeTracker/.

Code (YAML):
                                                                                                                                                                                                                   
  # ─────────────────────────────────────────                                                                                                                                                                                  
  #   TimeTracker - Configuration                                                                                                                                                                                              
  # ─────────────────────────────────────────                                                                                                                                                                                  
  # Use color codes with & (example: &a green, &c red, &d magenta, &e yellow)                                                                                                                                                  
  # Full list: https://minecraft.wiki/w/Formatting_codes                                                                                                                                                                        
  #                                                                                                                                                                                                                            
  # Available placeholders:                                                                                                                                                                                                    
  #   {prefix}    → the prefix defined below                                                                                                                                                                                    
  #   {player}    → player name                                                                                                                                                                                                
  #   {days}      → days played        (time.format, timetop.line-format)                                                                                                                                                      
  #   {hours}     → hours played       (time.format, timetop.line-format)                                                                                                                                                      
  #   {minutes}   → minutes played     (time.format, timetop.line-format)                                                                                                                                                      
  #   {position}  → rank position      (timetop.line-format only)                                                                                                                                                              
  #   {page}      → current page       (timetop.footer only)                                                                                                                                                                    
  #   {total}     → total pages        (timetop.footer only)                                                                                                                                                                    
                                                                                                                                                                                                                                 
  prefix
: "&d[TIME]"                                                                                                                                                                                                            
                                                                                                                                                                                                                                 
  # ── Command /playtime ────────────────────                                                                                                                                                                                  
  time
:                                                                                                                                                                                                                        
    player-only
: "&cThis command can only be used by players."                                                                                                                                                                  
    format
: "{prefix} &f{player} &f➤ &7Time played: &e{days} days, {hours} hours and {minutes} minutes."                                                                                                                        
                                                                                                                                                                                                                                 
  # ── Command /timetracker ─────────────────                                                                                                                                                                                  
  timetracker
:                                                                                                                                                                                                                  
    usage
: "&cUsage: &f/timetracker <reload|help|remove|restore>"                                                                                                                                                              
    reload
: "&aConfiguration reloaded successfully."                                                                                                                                                                            
    help-header
: "&8--------- &d[TimeTracker Help] &8---------"                                                                                                                                                                
    help-lines
:
     - "&e/playtime &7- Shows your total playtime."                                                                                                                                                                            
      - "&e/timetop [page] &7- Shows the top playtime ranking (offline included)."                                                                                                                                              
      - "&e/timetracker remove <player> &7- &c[OP] &7Removes a player from the top."                                                                                                                                            
      - "&e/timetracker restore <player> &7- &c[OP] &7Restores a removed player to the top."                                                                                                                                    
      - "&e/timetracker reload &7- &c[OP] &7Reloads the configuration."                                                                                                                                                        
      - "&e/timetracker help &7- Shows this help message."                                                                                                                                                                      
    help-footer
: "&8-----------------------------------------"                                                                                                                                                                  
    remove-no-permission
: "&cOnly operators can use this command."                                                                                                                                                              
    remove-usage
: "&cUsage: &f/timetracker remove <player>"                                                                                                                                                                    
    remove-not-found
: "&cPlayer &f{player} &cwas not found."                                                                                                                                                                    
    remove-success
: "&aPlayer &f{player} &ahas been permanently removed from the top."                                                                                                                                          
    restore-no-permission
: "&cOnly operators can use this command."                                                                                                                                                            
    restore-usage
: "&cUsage: &f/timetracker restore <player>"                                                                                                                                                                  
    restore-not-found
: "&cPlayer &f{player} &cwas not found."                                                                                                                                                                  
    restore-success
: "&aPlayer &f{player} &ahas been restored to the top."                                                                                                                                                      
                                                                                                                                                                                                                                 
  # ── Command /timetop ─────────────────────                                                                                                                                                                                  
  timetop
:                                                                                                                                                                                                                      
    no-players
: "&cNo player data found."                                                                                                                                                                                      
    header
: "&8--------- &d[TOP PLAYTIME] &8---------"                                                                                                                                                                          
    footer
: "&8-------- &7Page {page}&8/&7{total} &8--------"                                                                                                                                                                  
    line-format
: "&6{position}. &f{player} &f➤ &e{hours} hours"                                                                                                                                                                
 



Permissions

All commands are available to any player. The following require operator status:


  • /timetracker reload
  • /timetracker remove <player>
  • /timetracker restore <player>



Requirements

  • Paper 1.21.11+
  • Java 21+


Source Code

GitHub — offlnr/TimeTracker-Plugin
Resource Information
Author:
----------
Total Downloads: 6
First Release: Jun 14, 2026
Last Update: Jun 14, 2026
Category: ---------------
All-Time Rating:
0 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings