ModsJava
PlayTimePulse
I don't know my version or loader
Open the Minecraft launcher and look at the profile you play on — it names both, like fabric-loader-1.21.4. The version also shows in the bottom-right corner of the game's main menu.
No loader in the profile name? Then it's plain Minecraft, and these mods won't run — you need Fabric or NeoForge installed first.
⏱️ PlayTimePulse
A lightweight, accurate Minecraft plugin that tracks player playtime, integrates seamlessly with PlaceholderAPI, and provides a built-in rewards system with a claimable GUI.
🌟 Main Features
- ⏳ Real-time Playtime Tracking - Accurately tracks how long each player has been on your server
- 🎁 24+ Playtime Rewards - Milestone-based rewards that players can claim as they play more
- 📖 Pageable Rewards GUI - Easy-to-navigate interface with multiple pages for all rewards
- 🧾 Simple Commands - Intuitive
/playtimecommand for players and admin tools - 🔌 PlaceholderAPI Support - Integrates with popular plugins through placeholders
- 🛡️ AFK Protection - Prevents players from cheating by being AFK
- 💾 Efficient Data Storage - Lightweight flat-file storage with automatic saving
- ⚡ High Performance - Optimized code that won't slow down your server
- 🛡️ Reward Error Handling - Prevents reward spamming even when commands fail
- ⚙️ Flexible Configuration - Easily customize all rewards, GUI, and settings
📦 All Features
- ⏳ Real-time playtime tracking (saved + current session)
- 🧾
/playtimecommand:- Shows formatted playtime in
Xd Yh Zm - Opens a GUI to claim playtime-based rewards
- Shows formatted playtime in
- 🎁 Reward System:
- Milestone-based claimable rewards (24 rewards included in current config, with more to be added over time)
- Supports commands (since most of the things are given by commands)
- Blocks duplicate claiming with tracked saves
- Player head support for GUI icons (e.g., custom heads, player skulls)
- Custom sound effects when claiming rewards
- Error handling for failed commands to prevent reward spamming
- 📖 Pageable Rewards GUI:
- Pagination support for large numbers of rewards
- Customizable slots per page
- Navigation buttons for moving between pages
- 🧭 Navigation System:
- Previous/Next page buttons
- Close button to exit the GUI
- Customizable navigation button materials and names
- Optional custom head textures for navigation buttons
- 🛡️ AFK Protection:
- Prevents AFK farming of playtime
- Configurable interaction threshold and time window
- Tracks meaningful player interactions to validate activity
- 🔌 Full PlaceholderAPI support
- 📊 bStats integration for anonymous usage statistics
- 📁 Flat-file storage with autosave
- ⚙️ Performance optimized and easy to configure
🔧 Commands
| Command | Description | Permission |
|---|---|---|
/playtime |
Shows playtime and rewards GUI | playtime.use |
/playtime add <player> <hours>h [<minutes>m] |
Add playtime to player | playtime.admin |
/playtime reset <player> |
Reset player's playtime and claimed rewards | playtime.admin |
🧩 PlaceholderAPI Support
| Placeholder | Description |
|---|---|
%playtime_overall_formatted% |
Total time (saved + current), formatted like 2d 4h 30m |
%playtime_formatted% |
Current session only, formatted |
%playtime_overall% |
Total time in seconds (saved + current) |
%playtime_saved% |
Saved playtime only (in seconds) |
%playtime_current% |
Current online session (in seconds) |
🧪 Future Plans
- 🎨 Gradient color support for formatted text
- 🌟 Particle effects for reward claiming
- 🐛 Debug mode for easier troubleshooting
- ➕ More features coming soon
📁 Configuration
config.yml: Define playtime milestones, rewards (commands), requirements, rewards icon/lore, and sound effects.- Each reward can have a custom sound when claimed using the
claimSoundparameter - Choose from over 400 Minecraft sounds (e.g.,
entity.player.levelup,block.note_block.pling) - All sounds play at standard volume (1.0) and pitch (1.0)
- Custom heads can be added using
headIdwith Base64 texture values - Specify which page a reward should appear on using the
pageparameter (starting from 0) - Navigation buttons can use custom player heads with
headIdparameter - GUI slots and slots per page are configurable
- AFK protection settings:
interaction-threshold: Minimum number of interactions required in the time windowtime-window-minutes: Time window in minutes to check for interactions
- Each reward can have a custom sound when claimed using the
📥 Installation
- Download the latest release
- Drop the
.jarfile into your/pluginsfolder - Restart the server
- Configure
config.ymlto define rewards / requirements. - (Optional) Install PlaceholderAPI for placeholders
✅ Requirements
- Minecraft:
1.21 up to 1.21.8 - Java:
21+ - Server: Paper / Pufferfish / Purpur (others need testing)
- (Optional) PlaceholderAPI
📊 Statistics
PlayTimePulse collects anonymous usage statistics through bStats. This helps us understand how the plugin is used and guides future development.
You can view plugin statistics at bStats.
To opt out of statistics collection, set enabled: false in the /plugins/bStats/config.yml file.
💬 Support
- 📬 Open an issue
- 💻 Discord
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.21, 1.21.1, 1.21.2
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Modrinth — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
Verified by MCModsHub
- Ships as PlayTimePulse-1.0.5-SNAPSHOT.jar — drop this file into the mods folder
- Download size: 780 KB
- Download link checked 30 Aug 2026 — working
These come from our own check of the pack file, not from the source page.