Playtime

Minecraft 版本： 1.19 1.19.1 1.19.2 1.19.3 1.19.4 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2

平台： bukkit folia paper purpur spigot

标签： management social utility

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