?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings

PlayerTime

An advanced and lightweight playtime tracking plugin with daily, weekly, monthly, and yearly stats for Paper 26.2 and Purpur 26.2.

5downloads
0followers
5downloads
0followers

Compatibility

Minecraft: Java Edition

26.2

Platforms

Links

Report issues

Tags

Creators

Details

Licensed ARR
Published 4 days ago
Updated last month

PlayerTime ⏱️

An advanced, high-performance, and lightweight playtime tracking plugin built specifically for modern Minecraft servers running Paper 26.2, Purpur 26.2 and Java 25.

Unlike simple counters, PlayerTime breaks down player activity into detailed historical periods, allowing server administrators and players to track exactly how much time is spent on the server.

⭐ Features

  • 📊 Detailed Statistics: Tracks playtime dynamically and categorizes it into Today, This Week, This Month, This Year, and Total.
  • 🚀 Modern Core: Fully built using the modern Paper API and Kyori Adventure text engine for flawless performance.
  • 💾 Offline Caching: Saves and reads data for offline players without causing single-tick server lag.
  • 🔄 Automatic Resets: Smart internal date tracking automatically resets daily, weekly, monthly, and yearly stats exactly when midnight strikes.
  • 🔒 Asynchronous Saving: Periodically flushes all player statistics to userdata.yml safely in a background thread.
  • 🛰️ Built-in Updater: Features an asynchronous Update Checker that links directly to the GitHub Releases.

🎮 Commands

  • /playertime — Shows plugin information and correct command usage.
  • /playertime <player> — Displays a full detailed playtime breakdown for the specified player.
  • /playertime <player> <day/week/month/year/all> — Checks a specific time period for a player.

🔑 Permissions

  • playertime.use — Allows players to use the command and check stats (Granted to OP by default).
  • Fully compatible with LuckPerms!

📋 Requirements

  • Server Core: Paper 26.2 and Purpur 26.2 builds.
  • Java Version: Java 25

🛠️ Installation Guide

  1. Download the latest compiled binary (PlayerTime-1.0.jar) from the Versions section.
  2. Drop the .jar file into your server's plugins folder.
  3. Restart your server. Do not use /reload as it can break background data loops (if your server was offline, just start it).
  4. Configure permissions via your preferred permission manager (e.g., /lp group default permission set playertime.use true).

👥 Support & Bug Reports

If you encounter any bugs, errors, or have suggestions for new features, please open an official ticket in our Issues tracker.

❗ WARNING

THIS PLUGIN WAS CREATED ONLY FOR PAPER 26.2 AND PURPUR 26.2 BUILDS! DO NOT TRY TO USE THIS PLUGIN ON OTHER VERSIONS OF THE PAPER AND PURPUR, OR YOUR SERVER CAN CRASH!