Playtime Tracker

Playtime Tracker

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

56 downloads 0 followers

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.

Version Minecraft Loader Download

Playtime Tracker 1.0.0

1.0.0

1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11
folia, paper, purpur, spigot
Download