UltraPlayTime

A simple, powerful, and reliable plugin for tracking play time and AFK duration across your Minecraft server network.

UltraPlaytime allows you to accurately measure players' time on a specific server and connect multiple servers (Lobby, Survival, Creative...) via MySQL to sum total global playtime. It offers full integration with EssentialsX and a rich set of placeholders for PlaceholderAPI.

Supported Languages

• English (Default)
• Czech

✨ Features

• Network & Single Server Support – SQLite for standalone servers and MySQL for connected networks.
  
  
• Global & Local Statistics – Tracks play time separately per server while keeping a combined total global score.
  
  
• Smart AFK Integration – Full integration with EssentialsX for precise AFK tracking (optionally configure whether AFK time counts towards main playtime).
  
  
• Leaderboards (TOP) – Built-in leaderboards for top active players and top AFK players.
  
  
• ⚡ PlaceholderAPI Support – Extensive placeholders to display playtime in TAB, Scoreboards, Holograms, or Chat.
  
  
• Admin Tools – Modify player time (add, remove, set, reset) or migrate data when players change usernames.
  

Commands & Permissions
The primary command is /playtime (alias /ultraplaytime).

Player Commands
Permission: ultraplaytime.playtime.use (enabled for everyone by default)

Command description
/playtime - Shows your play time on the current server.
/playtime top [page] - Displays the leaderboard of top players on the current server.

️ Admin Commands
Permission: ultraplaytime.playtime.admin (OP by default)

Command description
/playtime admin help - Displays the help menu from the language file.
/playtime admin top <server|global> [page] - Displays TOP leaderboard for a specific server or global totals.
/playtime admin afktop [page] - Displays the top AFK players on the current server.
/playtime admin time <player> - Shows detailed breakdown of a player's time on each server, global total, and AFK time.
/playtime admin add <player> <time> <server> - Adds time to a player on the specified server.
/playtime admin set <player> <time> <server> - Sets exact playtime for a player on the specified server.
/playtime admin remove <player> <time> <server> - Subtracts time from a player (will not drop below 0).
/playtime admin reset <player> <server> - Resets a player's playtime on a specific server (alias: /resettime).
/playtime admin migrate <old_name> <new_name> - Transfers all saved data from an old account to a new one.
/playtime admin reload - Reloads configurations and language files.
/playtime admin importdata --confirm - (Console only) Import vanilla game statistics.

PlaceholderAPI (PAPI)
Placeholders are registered automatically when PlaceholderAPI is installed.

Current Server
%ultraplaytime_display% - Formatted playtime on the current server
%ultraplaytime_hours% - Full hours on the current server
%ultraplaytime_seconds% - Total seconds on the current server
%ultraplaytime_top_<rank>% - Player name and time at a specific position (e.g. %ultraplaytime_top_1%)

Specific Server & Global Totals

%ultraplaytime_server_<ServerName>% - Formatted playtime on a specific server (e.g. Survival)
%ultraplaytime_totalhours_<ServerName>% - Full hours on a specific server
%ultraplaytime_total%

Formatted total playtime across all servers

%ultraplaytime_global_hours% - Full hours across all servers
%ultraplaytime_total_seconds% - Total seconds across all servers
%ultraplaytime_afk% - Formatted global AFK time total
%ultraplaytime_afk_hours% - Full hours of global AFK time

Tip: Server name parameters in placeholders must match the server-name configured in config.yml.

⚙️ Configuration & MySQL Setup
For multi-server networks, connect each server instance to the same MySQL database and assign a unique, static server-name.

# Database Configuration Example
database:
type: MYSQL # SQLite / MYSQL
host: "127.0.0.1"
port: 3306
database: "minecraft_playtime"
username: "root"
password: "password"

server-name: "Survival" # Each server must have a unique identifier (Lobby, Survival, etc.)
useEssentialsApi: true
countAfkTime: false

⚠️ Note: Updating database connection details requires a full server restart. Executing /playtime admin reload reloads language texts and config parameters, but will not re-establish database pools.