# ⏱️ ccPlaytime **Modern, lightweight and configurable playtime tracking for Paper servers.** ccPlaytime tracks player activity, provides detailed statistics and leaderboards, and lets you reward players automatically when they reach playtime milestones. ## ✨ Features - Accurate playtime tracking - Offline time is never counted - Player statistics including joins, first join, last join and last quit - Cached playtime leaderboards - Configurable milestone rewards - SQLite and MariaDB/MySQL-compatible storage - Optional PlaceholderAPI support - MiniMessage formatting - English & German language files - Multiple playtime formats - Configurable command cooldowns - Asynchronous database operations ## ⌨️ Commands | Command | Description | | --- | --- | | `/playtime` | View your playtime | | `/playtime ` | View another player's playtime | | `/playtime info [player]` | View detailed player statistics | | `/playtime top [page]` | View the leaderboard | | `/ccplaytime help` | Show admin commands | | `/ccplaytime reload` | Reload the configuration | | `/ccplaytime save` | Save player data | | `/ccplaytime set ` | Set playtime | | `/ccplaytime add ` | Add playtime | | `/ccplaytime remove ` | Remove playtime | | `/ccplaytime reset ` | Reset playtime | | `/ccplaytime rewards reset [reward-id]` | Reset claimed rewards | Aliases: `/pt` and `/ccpt` ## 🔐 Permissions | Permission | Default | | --- | --- | | `ccplaytime.command.playtime` | Everyone | | `ccplaytime.command.playtime.others` | OP | | `ccplaytime.command.admin` | OP | | `ccplaytime.cooldown.bypass` | OP | ## 🧩 PlaceholderAPI [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) is **optional**. ccPlaytime works normally without it. ### Player Placeholders | Placeholder | Description | | --- | --- | | `%ccplaytime_playtime%` | Formatted total playtime | | `%ccplaytime_playtime_seconds%` | Total playtime in seconds | | `%ccplaytime_playtime_minutes%` | Total playtime in full minutes | | `%ccplaytime_playtime_hours%` | Total playtime in full hours | | `%ccplaytime_playtime_days%` | Total playtime in full days | | `%ccplaytime_joins%` | Total number of joins | | `%ccplaytime_first_join%` | First join date | | `%ccplaytime_last_join%` | Last join date | | `%ccplaytime_last_quit%` | Last quit date | | `%ccplaytime_last_session%` | Formatted duration of the last session | | `%ccplaytime_last_session_seconds%` | Last session duration in seconds | | `%ccplaytime_player_name%` | Stored player name | | `%ccplaytime_position%` | Player's cached leaderboard position | ### Leaderboard Placeholders | Placeholder | Description | | --- | --- | | `%ccplaytime_top__name%` | Player name at the specified leaderboard position | | `%ccplaytime_top__playtime%` | Formatted playtime at the specified position | | `%ccplaytime_top__seconds%` | Raw playtime in seconds at the specified position | ### Examples | Placeholder | Result | | --- | --- | | `%ccplaytime_top_1_name%` | Name of the #1 player | | `%ccplaytime_top_1_playtime%` | Playtime of the #1 player | | `%ccplaytime_top_2_name%` | Name of the #2 player | | `%ccplaytime_top_3_playtime%` | Playtime of the #3 player | | `%ccplaytime_top_10_name%` | Name of the #10 player | > Leaderboard positions are dynamic. Replace `` with any valid position, such as `1`, `2`, `3`, `10`, etc. Player-specific placeholders use ccPlaytime's cached player data and do not perform a synchronous database query every time they are requested.

ccPlaytime

1.0.0