⏱ 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."