Playtime Tracker

Playtime Tracker

A plugin to track the active* playtime of your players!

11 downloads

CommandsTracks each player's active (non-AFK) playtime, gated behind LuckPerms permissions, to power a rewards program for the most active players on your server. One jar, runs on Paper, Spigot, Purpur, and Folia

AFK-aware tracking — movement, block/inventory interaction, chat, commands, and combat all count as activity; pure camera-look movement doesn't, so anti-AFK macros don't farm rewards. AFK time is tracked separately from active time, not just dropped.

  • LuckPerms-gated commands — every subcommand is a standard Bukkit permission node, managed by LuckPerms the normal way. Reward actions can also add groups / promote tracks directly via the LuckPerms API.
  • Config-driven rewards — playtime and login-streak milestones, plus daily/weekly/monthly leaderboard payouts, run console commands (or first-class vault:give / luckperms:addgroup / luckperms:promote actions) — no hard dependency on any specific economy plugin.
  • Hall of Fame — past leaderboard periods are archived, not just overwritten, browsable in a chest GUI.
  • Login streaks — consecutive-day play tracked and rewarded separately from raw playtime.
  • Visual details — MiniMessage-driven /playtime stat card with a progress-to-next-reward bar, paginated leaderboard/Hall of Fame GUIs, live action bar and optional scoreboard, AFK tab-list tag, PlaceholderAPI expansion, Discord webhook announcements.
  • WorldGuard region rules (optional) — flag known AFK-farm regions as "never active", or flag a legitimate AFK lounge as exempt from detection.
  • Temporary event multipliers/playtime event 2 1h for a timed 2x active-time window.
  • SQLite by default, MySQL optional — zero-config out of the box; point at MySQL/MariaDB for a shared BungeeCord/Velocity network.
  • CSV export for admins auditing the rewards program.

Optional: LuckPerms, PlaceholderAPI, Vault (+ an economy plugin), WorldGuard

Set stealth-mode: true in config.yml to suppress every player-facing notification at once: AFK enter/exit broadcasts, the pre-AFK warning, the live action bar, the sidebar scoreboard, the tab-list [AFK] tag, and all reward/leaderboard announcements (in-game and Discord). Reward commands (vault:give, luckperms:addgroup, etc.) still run — only the announcements are suppressed, so you can keep paying out rewards silently.

The individual toggles (afk.broadcast-status-changes, visuals.actionbar.enabled, each milestone's announce, each leaderboard-rewards.<period>.announce, etc.) still work normally when stealth-mode is false, if you want more surgical control instead of the all-at-once switch.

Stealth mode does not touch permissions. playtime.use and playtime.top default to true for everyone, so players can still run /playtime and see their own stats/the leaderboard unless you revoke those nodes via your permissions plugin (e.g. /lp group default permission set playtime.use false).

No gallery available for this project.