# \u23f1\ufe0f PlayTimePulse<\/p>\n
A lightweight, accurate Minecraft plugin that tracks player playtime, integrates seamlessly with PlaceholderAPI, and provides a built-in rewards system with a claimable GUI.<\/p>\n
—<\/p>\n
## \ud83c\udf1f Main Features<\/p>\n
– \u23f3 **Real-time Playtime Tracking** – Accurately tracks how long each player has been on your server
\n– \ud83c\udf81 **24+ Playtime Rewards** – Milestone-based rewards that players can claim as they play more
\n– \ud83d\udcd6 **Pageable Rewards GUI** – Easy-to-navigate interface with multiple pages for all rewards
\n– \ud83e\uddfe **Simple Commands** – Intuitive `\/playtime` command for players and admin tools
\n– \ud83d\udd0c **PlaceholderAPI Support** – Integrates with popular plugins through placeholders
\n– \ud83d\udee1\ufe0f **AFK Protection** – Prevents players from cheating by being AFK
\n– \ud83d\udcbe **Efficient Data Storage** – Lightweight flat-file storage with automatic saving
\n– \u26a1 **High Performance** – Optimized code that won’t slow down your server
\n– \ud83d\udee1\ufe0f **Reward Error Handling** – Prevents reward spamming even when commands fail
\n– \u2699\ufe0f **Flexible Configuration** – Easily customize all rewards, GUI, and settings<\/p>\n
## \ud83d\udce6 All Features<\/p>\n
– \u23f3 Real-time playtime tracking (saved + current session)
\n– \ud83e\uddfe `\/playtime` command:
\n – Shows formatted playtime in `Xd Yh Zm`
\n – Opens a GUI to claim playtime-based rewards
\n– \ud83c\udf81 Reward System:
\n – Milestone-based claimable rewards (24 rewards included in current config, with more to be added over time)
\n – Supports commands (since most of the things are given by commands)
\n – Blocks duplicate claiming with tracked saves
\n – Player head support for GUI icons (e.g., custom heads, player skulls)
\n – Custom sound effects when claiming rewards
\n – Error handling for failed commands to prevent reward spamming
\n– \ud83d\udcd6 Pageable Rewards GUI:
\n – Pagination support for large numbers of rewards
\n – Customizable slots per page
\n – Navigation buttons for moving between pages
\n– \ud83e\udded Navigation System:
\n – Previous\/Next page buttons
\n – Close button to exit the GUI
\n – Customizable navigation button materials and names
\n – Optional custom head textures for navigation buttons
\n– \ud83d\udee1\ufe0f AFK Protection:
\n – Prevents AFK farming of playtime
\n – Configurable interaction threshold and time window
\n – Tracks meaningful player interactions to validate activity
\n– \ud83d\udd0c Full PlaceholderAPI support
\n– \ud83d\udcca bStats integration for anonymous usage statistics
\n– \ud83d\udcc1 Flat-file storage with autosave
\n– \u2699\ufe0f Performance optimized and easy to configure<\/p>\n
—<\/p>\n
## \ud83d\udd27 Commands<\/p>\n
| Command | Description | Permission | —<\/p>\n ## \ud83e\udde9 PlaceholderAPI Support<\/p>\n | Placeholder | Description | —<\/p>\n ## \ud83e\uddea Future Plans<\/p>\n – \ud83c\udfa8 Gradient color support for formatted text —<\/p>\n ## \ud83d\udcc1 Configuration<\/p>\n – `config.yml`: Define playtime milestones, rewards (commands), requirements, rewards icon\/lore, and sound effects. —<\/p>\n ## \ud83d\udce5 Installation<\/p>\n 1. Download the latest release —<\/p>\n ## \u2705 Requirements<\/p>\n – Minecraft: `1.21 up to 1.21.8` —<\/p>\n ## \ud83d\udcca Statistics<\/p>\n PlayTimePulse collects anonymous usage statistics through bStats. This helps us understand how the plugin is used and guides future development.<\/p>\n You can view plugin statistics at bStats.<\/p>\n To opt out of statistics collection, set `enabled: false` in the `\/plugins\/bStats\/config.yml` file.<\/p>\n —<\/p>\n ## \ud83d\udcac Support<\/p>\n – \ud83d\udcec Open an issue A lightweight, accurate playtime tracker with rewards, GUI, pre-config and PlaceholderAPI support.<\/p>\n","protected":false},"featured_media":122959,"template":"","meta":{"_minecraft_slug":"playtimepulse","_minecraft_project_id":"jnlYsGGt","_minecraft_author":"Murk3d","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":725,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"playtimepulse.zip","_minecraft_size_bytes":2882548,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-16T09:30:29.598034Z","_minecraft_date_created":"2025-07-18T03:18:25.741168Z","_minecraft_date_modified":"2025-08-13T15:49:50.324490Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/playtimepulse","_minecraft_icon_attachment_id":122959,"_minecraft_imported_at":"2026-06-07T05:34:08+00:00","_minecraft_import_hash":"5fd10c8a74e6eabfda461a823484c582","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,125,89,126,127,128,129,92,992],"mod_loader":[130,131,132,133,134,993],"minecraft_version":[62,37,73,74,38,78,79,80,81],"class_list":["post-122958","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-folia","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-utility","mod_category-waterfall","mod_loader-bukkit","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","mod_loader-waterfall","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8"],"yoast_head":"\n
\n|————————————————|———————————————|—————-|
\n| `\/playtime` | Shows playtime and rewards GUI | playtime.use |
\n| `\/playtime add
\n| `\/playtime reset
\n|——————————–|———————————————————-|
\n| `%playtime_overall_formatted%` | Total time (saved + current), formatted like `2d 4h 30m` |
\n| `%playtime_formatted%` | Current session only, formatted |
\n| `%playtime_overall%` | Total time in seconds (saved + current) |
\n| `%playtime_saved%` | Saved playtime only (in seconds) |
\n| `%playtime_current%` | Current online session (in seconds) |<\/p>\n
\n– \ud83c\udf1f Particle effects for reward claiming
\n– \ud83d\udc1b Debug mode for easier troubleshooting
\n– \u2795 More features coming soon<\/p>\n
\n – Each reward can have a custom sound when claimed using the `claimSound` parameter
\n – Choose from over 400 Minecraft sounds (e.g., `entity.player.levelup`, `block.note_block.pling`)
\n – All sounds play at standard volume (1.0) and pitch (1.0)
\n – Custom heads can be added using `headId` with Base64 texture values
\n – Specify which page a reward should appear on using the `page` parameter (starting from 0)
\n – Navigation buttons can use custom player heads with `headId` parameter
\n – GUI slots and slots per page are configurable
\n – AFK protection settings:
\n – `interaction-threshold`: Minimum number of interactions required in the time window
\n – `time-window-minutes`: Time window in minutes to check for interactions<\/p>\n
\n2. Drop the `.jar` file into your `\/plugins` folder
\n3. Restart the server
\n4. Configure `config.yml` to define rewards \/ requirements.
\n5. (Optional) Install PlaceholderAPI for placeholders<\/p>\n
\n– Java: `21+`
\n– Server: Paper \/ Pufferfish \/ Purpur (others need testing)
\n– (Optional) PlaceholderAPI<\/p>\n
\n– \ud83d\udcbb Discord<\/p>\n","protected":false},"excerpt":{"rendered":"