Playtime

A lightweight Paper plugin that tracks player playtime without needing Essentials, Minecraft statistics, or another playtime plugin.

---

What does it track?

It tracks several types of playtime separately:

Type	Description
Today	Playtime earned during the current day
This Month	Playtime earned during the current month
All-Time	Total playtime tracked by hPlaytime
Events	Temporary playtime contests with their own logs

This plugin starts tracking from the moment it is installed. It does not import Essentials data or use Minecraft statistics.

---

Commands

User

Command	Permission	Description
/playtime	hplaytime.use	Shows your own playtime
/pt	hplaytime.use	Alias for /playtime
/playtime <player>	hplaytime.others	Shows another player's playtime
/playtime top	hplaytime.use	Shows the top 10 all-time playtime leaderboard
/playtime topday	hplaytime.use	Shows the top 10 daily playtime leaderboard
/playtime topmonth	hplaytime.use	Shows the top 10 monthly playtime leaderboard

Admin

Command	Permission	Description
/hplaytime reload	hplaytime.reload	Reloads config, language, storage settings, AFK settings, and formats
/hplaytime reset <player>	hplaytime.reset	Resets one player' main playtime
/hplaytime resetall	hplaytime.resetall	Resets all players' main playtime

Events

Command	Permission	Description
/playtime event create <name> <duration>	hplaytime.event.create	Creates a playtime event
/playtime start <name>	hplaytime.event.start	Starts an event fresh
/playtime event end <name>	hplaytime.event.end	Ends an event and writes a log
/playtime event delete <name>	hplaytime.event.delete	Deletes active event tracking files
/event list	hplaytime.event.list	Lists events

Example:

/playtime event create weekend 24h
/playtime start weekend

Supported duration examples:

24h
7d
1h30m
45m

Permissions

Permission	Default	Description
hplaytime.use	Everyone	Use /playtime
hplaytime.others	OP	Check another player's playtime
hplaytime.reload	OP	Reload hPlaytime
hplaytime.reset	OP	Reset one player's main playtime
hplaytime.resetall	OP	Reset all main playtime
hplaytime.event.create	OP	Create playtime events
hplaytime.event.start	OP	Start playtime events
hplaytime.event.end	OP	End playtime events
hplaytime.event.delete	OP	Delete event tracking files
hplaytime.event.list	OP	List events

---

Features

• Standalone playtime tracking
• Daily, monthly, and all-time totals
• Temporary playtime events
• Local YAML storage by default
• Optional MySQL storage
• Built-in AFK protection
• AFK worlds where playtime does not count
• Optional last-seen display
• Configurable date, timezone, and time formatting
• Fully editable lang.yml
• Player and global reset commands
• Event winner broadcasts
• Permanent event result logs
• Simple text commands, no GUI required

---

Requirements

Requirement	Version
Server Software	Paper 1.21.10+
Java	Java 21+

MySQL is optional. hPlaytime uses local YAML storage by default.

---

Installation

1. Download the latest jar.
2. Place it inside your server’s plugins folder.
3. Restart your server.
4. Edit the generated files in plugins/hPlaytime/.
5. Run /hplaytime reload after making changes.

---

Plugin Files

hPlaytime creates its own folder inside your server’s plugins directory.

Path	Purpose
config.yml	Storage, formatting, AFK, AFK worlds, and save settings
lang.yml	Editable plugin messages
data/	Local player playtime files
events/	Active event tracking files
event-logs/	Saved event result logs

Storage Settings

hPlaytime supports local YAML storage and MySQL.

Local storage is enabled by default:

storage:
  type: local

Local player data is saved here:

plugins/hPlaytime/data/<uuid>.yml

This is the simplest option and is recommended for single-server setups.

To use MySQL:

storage:
  type: mysql

  mysql:
    host: localhost
    port: 3306
    database: minecraft
    username: root
    password: ""
    use-ssl: false
    table-prefix: hplaytime_

hPlaytime creates the required MySQL tables automatically.

Main playtime can use MySQL, but event tracking is currently local-file based.

AFK Protection

hPlaytime includes its own AFK system. It does not rely on Essentials AFK.

afk:
  enabled: true
  timeout-seconds: 300

  worlds:
    - afk

When a player is inactive, new playtime stops counting until they move, interact, or run a command.

Players in configured AFK worlds do not gain:

• Main playtime
• Event playtime

Date, Time, and Last Seen Formatting

Date keys and timezone are configurable in config.yml.

date-format:
  timezone: system
  daily-pattern: yyyy-MM-dd
  monthly-pattern: yyyy-MM

Use timezone: system for the server machine timezone, or use a Java timezone ID:

timezone: America/Chicago

Time output can also be customized:

time-format:
  style: compact
  show-seconds: true
  zero: 0s

Compact output example:

1d 4h 22m

Long output example:

1 day 4 hours 22 minutes

Last-seen output can be enabled, disabled, or reformatted:

last-seen:
  enabled: true
  pattern: yyyy-MM-dd HH:mm:ss z

Language File

All messages are editable in:

plugins/hPlaytime/lang.yml

Messages support & color codes.

Common placeholders:

Placeholder	Description
%prefix%	Configured prefix from lang.yml
%player%	Player name
%today%	Today's playtime
%month%	This month's playtime
%alltime%	All-time playtime
%lastseen%	Last-seen status
%event%	Event name
%duration%	Event duration
%time%	Formatted time
%events%	Event list

After editing lang.yml, run:

/hplaytime reload

---

Important Notes

• hPlaytime starts tracking after it is installed.
• It does not import Essentials playtime.
• It does not use Minecraft statistics for all-time totals.
• Reset commands affect main playtime only.
• Reset commands do not delete event logs.
• AFK timeout applies to main playtime and event playtime.
• AFK worlds apply to main playtime and event playtime.
• Event logs are kept even after an event is deleted.
• Event tracking is currently local-file based, even when MySQL is enabled.

Support

If you find a bug or have a suggestion, please open an issue on GitHub with your server version, plugin version, and any relevant console errors.

The plugin is actively maintained, but new features are added carefully to keep it lightweight.

---

Authors

• HBOJ

Sponsored By

• AsteroidMC

License

• ARR License