PlayTime » 1.17 - 1.21.11 icon

PlayTime » 1.17 - 1.21.11 -----

Track players playtime, reward them for it, & easily see the top playtimes. The all-in-one solution.




PlayTime is the #1 plugin for tracking
your players' playtime, allowing your
players to view their and other playtimes,
as well as rewarding your players for
their playtime, and having it all easily
viewable via multiple configurable GUIs.

Supports Bungee/Velocity network servers
via MySQL database. This requires you to
install PlayTime on each sub-server and
set up the MySQL settings as well as
enable the cross-server settings.

[​IMG]

Commands »

[​IMG]

Aliases:
pt, playertime, onlinetime, timeplayed, ot

Permissions »
Permission Description
Code (Text):
playtime.reload
Access to the reload sub-command.
Code (Text):
playtime.clearrewards
Access to the clearrewards sub-command.

Images »

(/playtime)
[​IMG]

(/playtime top)
[​IMG]

(/playtime rewards)
[​IMG]
[​IMG]

(/playtime clearrewards (player))
[​IMG]

Chat notification upon auto-claiming a reward: [​IMG]

PlaceholderAPI »​
Placeholder Description
Code (Text):
%playtime_playtime%
Displays the total playtime of the player viewing the placeholder (formatted).
Code (Text):
%playtime_playtime_seconds%
Displays the total playtime of the player viewing the placeholder in raw seconds.
Code (Text):
%playtime_playtime_seconds_no_label%
Alias of
Code (Text):
%playtime_playtime_seconds%
(number only).
Code (Text):
%playtime_<name>_playtime%
Displays the total playtime of the specified player (formatted). Example:
Code (Text):
%playtime_Notch_playtime%
Code (Text):
%playtime_<name>_server_playtime%
Displays the total playtime of the specified player counted only on the current backend server (formatted). Example:
Code (Text):
%playtime_Notch_server_playtime%
Code (Text):
%playtime_top_<spot>_name%
Displays the username at a top position (1+). Returns your configured no-data fallback if there’s no player at that position.
Code (Text):
%playtime_top_<spot>_displayname%
Displays the display name (supports PlaceholderAPI prefixes/color if available) at a top position (1+). Falls back to username, then to no-data.
Code (Text):
%playtime_top_<spot>_time%
Displays the total playtime at a top position (1+), formatted.
Code (Text):
%playtime_top_position%
Shows the viewer’s current rank (1-based) among non-excluded players. Aliases:
Code (Text):
%playtime_position%
,
Code (Text):
%playtime_rank%
. Returns no-data if not ranked.
— Total playtime (overall) —
Code (Text):
%playtime_playtime_weeks%
Total playtime in weeks (with label).
Code (Text):
%playtime_playtime_days%
Total playtime in days (with label).
Code (Text):
%playtime_playtime_hours%
Total playtime in hours (with label).
Code (Text):
%playtime_playtime_minutes%
Total playtime in minutes (with label).
Code (Text):
%playtime_playtime_weeks_no_label%
Total playtime in weeks (number only).
Code (Text):
%playtime_playtime_days_no_label%
Total playtime in days (number only).
Code (Text):
%playtime_playtime_hours_no_label%
Total playtime in hours (number only).
Code (Text):
%playtime_playtime_minutes_no_label%
Total playtime in minutes (number only).
— Server-specific total playtime (this backend only) —
Code (Text):
%playtime_server_playtime%
Displays the player’s total playtime counted only on the current backend server (formatted).
Code (Text):
%playtime_server_playtime_seconds%
Displays the player’s total playtime on the current backend server in raw seconds.
Code (Text):
%playtime_server_playtime_seconds_no_label%
Alias of server playtime seconds (number only).
Code (Text):
%playtime_server_playtime_weeks%
Server-specific total playtime in weeks (with label).
Code (Text):
%playtime_server_playtime_days%
Server-specific total playtime in days (with label).
Code (Text):
%playtime_server_playtime_hours%
Server-specific total playtime in hours (with label).
Code (Text):
%playtime_server_playtime_minutes%
Server-specific total playtime in minutes (with label).
Code (Text):
%playtime_server_playtime_weeks_no_label%
Server-specific total playtime in weeks (number only).
Code (Text):
%playtime_server_playtime_days_no_label%
Server-specific total playtime in days (number only).
Code (Text):
%playtime_server_playtime_hours_no_label%
Server-specific total playtime in hours (number only).
Code (Text):
%playtime_server_playtime_minutes_no_label%
Server-specific total playtime in minutes (number only).
— AFK playtime (overall) —
Code (Text):
%playtime_playtime_afk%
Total AFK time (formatted).
Code (Text):
%playtime_playtime_afk_seconds%
Total AFK time in raw seconds.
Code (Text):
%playtime_playtime_afk_seconds_no_label%
Alias of AFK seconds (number only).
Code (Text):
%playtime_playtime_afk_hours%
Total AFK time in hours (with label).
Code (Text):
%playtime_playtime_afk_minutes%
Total AFK time in minutes (with label).
Code (Text):
%playtime_playtime_afk_hours_no_label%
Total AFK time in hours (number only).
Code (Text):
%playtime_playtime_afk_minutes_no_label%
Total AFK time in minutes (number only).
— Active playtime (overall) —
Code (Text):
%playtime_playtime_active%
Total active time (total minus AFK, formatted).
Code (Text):
%playtime_playtime_active_seconds%
Total active time in raw seconds.
Code (Text):
%playtime_playtime_active_seconds_no_label%
Alias of active seconds (number only).
Code (Text):
%playtime_playtime_active_hours%
Total active time in hours (with label).
Code (Text):
%playtime_playtime_active_minutes%
Total active time in minutes (with label).
Code (Text):
%playtime_playtime_active_hours_no_label%
Total active time in hours (number only).
Code (Text):
%playtime_playtime_active_minutes_no_label%
Total active time in minutes (number only).
— Session (overall) —
Code (Text):
%playtime_session%
Displays the player’s current session playtime (formatted).
Code (Text):
%playtime_session_seconds%
Displays the player’s current session playtime in raw seconds.
Code (Text):
%playtime_session_seconds_no_label%
Alias of session seconds (number only).
Code (Text):
%playtime_session_hours%
Current session playtime in hours (with label).
Code (Text):
%playtime_session_minutes%
Current session playtime in minutes (with label).
Code (Text):
%playtime_session_hours_no_label%
Current session playtime in hours (number only).
Code (Text):
%playtime_session_minutes_no_label%
Current session playtime in minutes (number only).
Code (Text):
%playtime_session_days%
Current session playtime in days (with label).
Code (Text):
%playtime_session_days_no_label%
Current session playtime in days (number only).
Code (Text):
%playtime_session_weeks%
Current session playtime in weeks (with label).
Code (Text):
%playtime_session_weeks_no_label%
Current session playtime in weeks (number only).
— Daily (overall) —
Code (Text):
%playtime_daily%
Displays the player’s playtime for today (formatted).
Code (Text):
%playtime_daily_hours%
Today’s playtime in hours (with label).
Code (Text):
%playtime_daily_minutes%
Today’s playtime in minutes (with label).
Code (Text):
%playtime_daily_seconds%
Today’s playtime in seconds (with label).
Code (Text):
%playtime_daily_hours_no_label%
Today’s playtime in hours (number only).
Code (Text):
%playtime_daily_minutes_no_label%
Today’s playtime in minutes (number only).
Code (Text):
%playtime_daily_seconds_no_label%
Today’s playtime in seconds (number only).
Code (Text):
%playtime_daily_days%
Today’s playtime in days (with label).
Code (Text):
%playtime_daily_days_no_label%
Today’s playtime in days (number only).
— Daily (per reward key) —
Code (Text):
%playtime_daily_<key>_current%
Today’s current progress toward the daily reward (formatted).
Code (Text):
%playtime_daily_<key>_required%
Required time for the daily reward (formatted).
Code (Text):
%playtime_daily_<key>_remaining%
Remaining time to reach the daily reward (formatted).
Code (Text):
%playtime_daily_<key>_progress%
Displays progress as
Code (Text):
current / required
(formatted).
Code (Text):
%playtime_daily_<key>_progress_percent%
Displays percent progress (0–100%).
— Session (per reward key) —
Code (Text):
%playtime_session_<key>_current%
Current session progress toward the session reward (formatted).
Code (Text):
%playtime_session_<key>_required%
Required session time for the reward (formatted).
Code (Text):
%playtime_session_<key>_remaining%
Remaining session time to reach the reward (formatted).
Code (Text):
%playtime_session_<key>_progress%
Displays progress as
Code (Text):
current / required
(formatted).
Code (Text):
%playtime_session_<key>_progress_percent%
Displays percent progress (0–100%).
— Unique (per reward key) —
Code (Text):
%playtime_unique_<key>_current%
Current total playtime toward the unique reward (formatted).
Code (Text):
%playtime_unique_<key>_required%
Required total playtime to unlock the unique reward (formatted).
Code (Text):
%playtime_unique_<key>_remaining%
Remaining time to the unique reward (formatted).
Code (Text):
%playtime_unique_<key>_progress%
Displays progress as
Code (Text):
current / required
(formatted).
Code (Text):
%playtime_unique_<key>_progress_percent%
Displays percent progress (0–100%).
— Constant (per reward key; progress toward next cycle) —
Code (Text):
%playtime_constant_<key>_current%
Current cycle progress (time since last constant reward; formatted).
Code (Text):
%playtime_constant_<key>_required%
Interval length for the constant reward (formatted).
Code (Text):
%playtime_constant_<key>_remaining%
Remaining time until the next constant reward (formatted).
Code (Text):
%playtime_constant_<key>_progress%
Displays cycle progress as
Code (Text):
current / required
(formatted).
Code (Text):
%playtime_constant_<key>_progress_percent%
Displays percent cycle progress (0–100%).
— Streaks (per streak key) —
Code (Text):
%playtime_streak_<key>_days%
Total days required to complete the streak.
Code (Text):
%playtime_streak_<key>_duration%
Required daily duration (pretty format, e.g. “1h”, “30m”).
Code (Text):
%playtime_streak_<key>_count%
Current consecutive days achieved toward the streak.
Code (Text):
%playtime_streak_<key>_progress%
Displays streak progress as
Code (Text):
days_played / days
.
Code (Text):
%playtime_streak_<key>_claimed_today%
Whether the streak reward was claimed for the most recent completed day (true/false).
— Historical per-day playtime (specific date) —
Code (Text):
%playtime_day_<yyyy-MM-dd>%
Displays the viewer’s total playtime on a specific calendar day (formatted). Example:
Code (Text):
%playtime_day_2024-12-05%
→ playtime on 5th December 2024.
Code (Text):
%playtime_day_<yyyy-MM-dd>_seconds%
Viewer’s total playtime on that day in raw seconds. Example:
Code (Text):
%playtime_day_2024-12-05_seconds%
Code (Text):
%playtime_day_<yyyy-MM-dd>_seconds_no_label%
Alias of day seconds (number only). Example:
Code (Text):
%playtime_day_2024-12-05_seconds_no_label%
— Historical per-month playtime (specific month) —
Code (Text):
%playtime_month_<yyyy-MM>%
Displays the viewer’s total playtime during a specific month (formatted). Example:
Code (Text):
%playtime_month_2024-11%
→ total playtime in November 2024.
Code (Text):
%playtime_month_<yyyy-MM>_seconds%
Viewer’s total playtime for that month in raw seconds. Example:
Code (Text):
%playtime_month_2024-11_seconds%
Code (Text):
%playtime_month_<yyyy-MM>_seconds_no_label%
Alias of month seconds (number only). Example:
Code (Text):
%playtime_month_2024-11_seconds_no_label%
— Historical TOP: specific day —
Code (Text):
%playtime_top_day_<spot>_<yyyy-MM-dd>_name%
Username at a given rank based on playtime on a specific day. Example:
Code (Text):
%playtime_top_day_1_2024-12-05_name%
→ #1 player on 5th December 2024 by playtime.
Code (Text):
%playtime_top_day_<spot>_<yyyy-MM-dd>_displayname%
Display name at that rank (uses PlaceholderAPI for prefixes/colors; falls back to username then no-data). Example:
Code (Text):
%playtime_top_day_3_2024-12-05_displayname%
Code (Text):
%playtime_top_day_<spot>_<yyyy-MM-dd>_time%
Formatted playtime of the player at that rank for the given day. Example:
Code (Text):
%playtime_top_day_5_2024-12-05_time%
— Historical TOP: specific month —
Code (Text):
%playtime_top_month_<spot>_<yyyy-MM>_name%
Username at a given rank based on total playtime during a specific month. Example:
Code (Text):
%playtime_top_month_1_2024-11_name%
→ #1 player in November 2024.
Code (Text):
%playtime_top_month_<spot>_<yyyy-MM>_displayname%
Display name at that rank for the given month (with PlaceholderAPI support). Example:
Code (Text):
%playtime_top_month_2_2024-11_displayname%
Code (Text):
%playtime_top_month_<spot>_<yyyy-MM>_time%
Formatted playtime of the player at that rank for the given month. Example:
Code (Text):
%playtime_top_month_10_2024-11_time%

Configurable files »

config.yml
messages.yml

Support »
The quickest way to get support for any of my resources
would be to join my Resource Discord.
» https://discord.gg/2vUqykD

Note »
Please DO NOT leave bad reviews for any issues
that you have. Please simply PM me or leave it
in the discussion tab. Thank you. (y)

That and reviews are highly appreciated! :alien:

[​IMG]

My other plugins

[​IMG] [​IMG] [​IMG] [​IMG] [​IMG] [​IMG] [​IMG]
Resource Information
Author:
----------
Total Downloads: 12,084
First Release: Jul 31, 2017
Last Update: Yesterday at 5:50 PM
Category: ---------------
All-Time Rating:
19 ratings
Find more info at discord.gg...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings