![\"hPlaytime](\"https:\/\/raw.githubusercontent.com\/hbojoe\/hPlaytime\/refs\/heads\/main\/assets\/hPlaytime.png\")
\n<\/p>\n\n \n<\/p>\n
A lightweight Paper plugin that tracks player playtime without needing Essentials, Minecraft statistics, or another playtime plugin.<\/p>\n
—<\/p>\n
## What does it track?<\/p>\n
It tracks several types of playtime separately:<\/p>\n
| Type | Description |
\n| ————– | ———————————————– |
\n| **Today** | Playtime earned during the current day |
\n| **This Month** | Playtime earned during the current month |
\n| **All-Time** | Total playtime tracked by hPlaytime |
\n| **Events** | Temporary playtime contests with their own logs |<\/p>\n
This plugin starts tracking from the moment it is installed. It does not import Essentials data or use Minecraft statistics.<\/p>\n
—<\/p>\n <\/p>\n ### User<\/p>\n | Command | Permission | Description | ### Admin<\/p>\n | Command | Permission | Description | ### Events<\/p>\n | Command | Permission | Description | Example:<\/p>\n \/playtime event create weekend 24h Supported duration examples:<\/p>\n 24h <\/p>\n | Permission | Default | Description | —<\/p>\n ## Features<\/p>\n * Standalone playtime tracking —<\/p>\n ## Requirements<\/p>\n | Requirement | Version | MySQL is optional. hPlaytime uses local YAML storage by default.<\/p>\n —<\/p>\n ## Installation<\/p>\n 1. Download the latest jar. —<\/p>\n <\/p>\n hPlaytime creates its own folder inside your server\u2019s plugins directory.<\/p>\n | Path | Purpose | <\/p>\n hPlaytime supports local YAML storage and MySQL.<\/p>\n Local storage is enabled by default:<\/p>\n “` Local player data is saved here:<\/p>\n “` This is the simplest option and is recommended for single-server setups.<\/p>\n To use MySQL:<\/p>\n “` mysql: hPlaytime creates the required MySQL tables automatically.<\/p>\n Main playtime can use MySQL, but event tracking is currently local-file based.<\/p>\n<\/details>\n <\/p>\n hPlaytime includes its own AFK system. It does not rely on Essentials AFK.<\/p>\n “` worlds: When a player is inactive, new playtime stops counting until they move, interact, or run a command.<\/p>\n Players in configured AFK worlds do not gain:<\/p>\n * Main playtime <\/p>\n Date keys and timezone are configurable in `config.yml`.<\/p>\n “` Use `timezone: system` for the server machine timezone, or use a Java timezone ID:<\/p>\n “` Time output can also be customized:<\/p>\n “` Compact output example:<\/p>\n “` Long output example:<\/p>\n “` Last-seen output can be enabled, disabled, or reformatted:<\/p>\n “` <\/p>\n All messages are editable in:<\/p>\n “` Messages support `&` color codes.<\/p>\n Common placeholders:<\/p>\n | Placeholder | Description | After editing `lang.yml`, run:<\/p>\n “` —<\/p>\n ## Important Notes<\/p>\n * hPlaytime starts tracking after it is installed. ## Support<\/p>\n 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.<\/p>\n The plugin is actively maintained, but new features are added carefully to keep it lightweight.<\/p>\n","protected":false},"excerpt":{"rendered":" Standalone Paper playtime tracking with daily, monthly, all-time, AFK-safe, and event-based playtime support.<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"hplaytime","_minecraft_project_id":"QdGGK72k","_minecraft_author":"HBOJ","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":9,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"hplaytime.zip","_minecraft_size_bytes":8597965,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-15T23:12:20.539355Z","_minecraft_date_created":"2026-05-08T04:53:13.915229Z","_minecraft_date_modified":"2026-05-10T06:26:32.034251Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/hplaytime","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-04T17:29:38+00:00","_minecraft_import_hash":"0b79dced465e154da4603b8181d67778","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,126,127,128,867,92],"mod_loader":[132,133],"minecraft_version":[40,41,167,163],"class_list":["post-82415","mod","type-mod","status-publish","hentry","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n\nCommands<\/strong><\/summary>\n
\n| — | — | — |
\n| `\/playtime` | `hplaytime.use` | Shows your own playtime |
\n| `\/pt` | `hplaytime.use` | Alias for `\/playtime` |
\n| `\/playtime
\n| `\/playtime top` | `hplaytime.use` | Shows the top 10 all-time playtime leaderboard |
\n| `\/playtime topday` | `hplaytime.use` | Shows the top 10 daily playtime leaderboard |
\n| `\/playtime topmonth` | `hplaytime.use` | Shows the top 10 monthly playtime leaderboard |<\/p>\n
\n| — | — | — |
\n| `\/hplaytime reload` | `hplaytime.reload` | Reloads config, language, storage settings, AFK settings, and formats |
\n| `\/hplaytime reset
\n| `\/hplaytime resetall` | `hplaytime.resetall` | Resets all players’ main playtime |<\/p>\n
\n| — | — | — |
\n| `\/playtime event create
\n| `\/playtime start
\n| `\/playtime event end
\n| `\/playtime event delete
\n| `\/event list` | `hplaytime.event.list` | Lists events |<\/p>\n
\n \/playtime start weekend<\/p>\n
\n 7d
\n 1h30m
\n 45m<\/p>\n<\/details>\n\nPermissions<\/strong><\/summary>\n
\n| — | — | — |
\n| `hplaytime.use` | Everyone | Use `\/playtime` |
\n| `hplaytime.others` | OP | Check another player’s playtime |
\n| `hplaytime.reload` | OP | Reload hPlaytime |
\n| `hplaytime.reset` | OP | Reset one player’s main playtime |
\n| `hplaytime.resetall` | OP | Reset all main playtime |
\n| `hplaytime.event.create` | OP | Create playtime events |
\n| `hplaytime.event.start` | OP | Start playtime events |
\n| `hplaytime.event.end` | OP | End playtime events |
\n| `hplaytime.event.delete` | OP | Delete event tracking files |
\n| `hplaytime.event.list` | OP | List events |<\/p>\n<\/details>\n
\n* Daily, monthly, and all-time totals
\n* Temporary playtime events
\n* Local YAML storage by default
\n* Optional MySQL storage
\n* Built-in AFK protection
\n* AFK worlds where playtime does not count
\n* Optional last-seen display
\n* Configurable date, timezone, and time formatting
\n* Fully editable `lang.yml`
\n* Player and global reset commands
\n* Event winner broadcasts
\n* Permanent event result logs
\n* Simple text commands, no GUI required<\/p>\n
\n| ——————- | ———————— |
\n| **Server Software** | Paper 1.21.10 or 1.21.11 |
\n| **Java** | Java 21 |<\/p>\n
\n2. Place it inside your server\u2019s `plugins` folder.
\n3. Restart your server.
\n4. Edit the generated files in `plugins\/hPlaytime\/`.
\n5. Run `\/hplaytime reload` after making changes.<\/p>\n\nPlugin Files<\/strong><\/summary>\n
\n| ————- | ——————————————————- |
\n| `config.yml` | Storage, formatting, AFK, AFK worlds, and save settings |
\n| `lang.yml` | Editable plugin messages |
\n| `data\/` | Local player playtime files |
\n| `events\/` | Active event tracking files |
\n| `event-logs\/` | Saved event result logs |<\/p>\n<\/details>\n\nStorage Settings<\/strong><\/summary>\n
\nstorage:
\n type: local
\n“`<\/p>\n
\nplugins\/hPlaytime\/data\/
\n“`<\/p>\n
\nstorage:
\n type: mysql<\/p>\n
\n host: localhost
\n port: 3306
\n database: minecraft
\n username: root
\n password: “”
\n use-ssl: false
\n table-prefix: hplaytime_
\n“`<\/p>\n\nAFK Protection<\/strong><\/summary>\n
\nafk:
\n enabled: true
\n timeout-seconds: 300<\/p>\n
\n – afk
\n“`<\/p>\n
\n* Event playtime<\/p>\n<\/details>\n\nDate, Time, and Last Seen Formatting<\/strong><\/summary>\n
\ndate-format:
\n timezone: system
\n daily-pattern: yyyy-MM-dd
\n monthly-pattern: yyyy-MM
\n“`<\/p>\n
\ntimezone: America\/Chicago
\n“`<\/p>\n
\ntime-format:
\n style: compact
\n show-seconds: true
\n zero: 0s
\n“`<\/p>\n
\n1d 4h 22m
\n“`<\/p>\n
\n1 day 4 hours 22 minutes
\n“`<\/p>\n
\nlast-seen:
\n enabled: true
\n pattern: yyyy-MM-dd HH:mm:ss z
\n“`<\/p>\n<\/details>\n\nLanguage File<\/strong><\/summary>\n
\nplugins\/hPlaytime\/lang.yml
\n“`<\/p>\n
\n| ———— | ——————————— |
\n| `%prefix%` | Configured prefix from `lang.yml` |
\n| `%player%` | Player name |
\n| `%today%` | Today’s playtime |
\n| `%month%` | This month’s playtime |
\n| `%alltime%` | All-time playtime |
\n| `%lastseen%` | Last-seen status |
\n| `%event%` | Event name |
\n| `%duration%` | Event duration |
\n| `%time%` | Formatted time |
\n| `%events%` | Event list |<\/p>\n
\n\/hplaytime reload
\n“`<\/p>\n<\/details>\n
\n* It does not import Essentials playtime.
\n* It does not use Minecraft statistics for all-time totals.
\n* Reset commands affect main playtime only.
\n* Reset commands do not delete event logs.
\n* AFK timeout applies to main playtime and event playtime.
\n* AFK worlds apply to main playtime and event playtime.
\n* Event logs are kept even after an event is deleted.
\n* Event tracking is currently local-file based, even when MySQL is enabled.<\/p>\n