Description
Playtime Tracker
A simple server-side mod that tracks how long players have been playing on your server. Check your own playtime, see daily stats, look back at the last week, or see who's been grinding the most on the leaderboard.
Works great for SMPs and community servers where you want to keep track of who's putting in the hours.
Server-Side Only
Features
- Total Playtime Tracking — Tracks every player's total time spent on the server, even when restarting.
- Daily Breakdown — See how long anyone has played on a specific day.
- 7-Day History — Quick overview of your or people's playtime over the past week.
- Leaderboard — Top 10 players ranked by total playtime of the top 3.
- Per-Player Lookup — Check any player's stats, even if they're offline.
- Auto-Save — Playtime data is saved every 5 minutes so nothing is lost if the server crashes.
- Midnight Splitting — If you play past midnight, your time is split between both days.
Commands
Everyone
| Command | Description |
|---|---|
/playtime |
Shows your total playtime and current session |
/playtime today |
Shows how long you've played today |
/playtime day <YYYY-MM-DD> |
Shows your playtime on a specific date |
/playtime history |
Shows your playtime for the last 7 days |
/playtime leaderboard |
Shows the top 10 players by playtime |
Player Lookup
| Command | Description |
|---|---|
/playtime <player> |
Check another player's total playtime |
/playtime <player> today |
Check their playtime today |
/playtime <player> history |
Check their last 7 days |
/playtime <player> day <YYYY-MM-DD> |
Check their playtime on a specific date |
How It Works
When a player joins the server, the mod starts tracking their time. When they leave, it takes how long they were on and saves it to a JSON file in your world folder. The mod auto-saves every 5 minutes so if the server crashes, you will only lose a few minutes of data at most.
All times are displayed in Eastern Time (America/New_York) by default.
Installation
- Download the jar and drop it in your server's
mods folder - Start the server.
- Thats it
Supported Versions: Minecraft 1.21.1 (NeoForge)
Any concerns or questions: Leave a comment and I'll check it out.