hPlaytime Banner

# 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 ` | `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 ` | `hplaytime.reset` | Resets one player' main playtime | | `/hplaytime resetall` | `hplaytime.resetall` | Resets all players' main playtime | ### Events | Command | Permission | Description | | --- | --- | --- | | `/playtime event create ` | `hplaytime.event.create` | Creates a playtime event | | `/playtime start ` | `hplaytime.event.start` | Starts an event fresh | | `/playtime event end ` | `hplaytime.event.end` | Ends an event and writes a log | | `/playtime event delete ` | `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/.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

Playtime

Compatibility

Minecraft: Java Edition

Platforms

Links

Tags

Creators

Details

/playtime <player>

/playtime top