Paper/Folia/Spigot: gentle playtime reminders, milestone alerts, AFK-aware tracking, and optional session limits.
Part of the Ninja6-MC plugin suite.
Status
Pre-release. Every version before 1.0.0 is a pre-release, and 1.0.0 will be the first stable one. Until then, configuration keys and behaviour may still change between versions; read the changelog before upgrading.
Alpha builds are published as GitHub pre-releases, as Modrinth alpha versions and to Hangar's Alpha channel, which Hangar hides by default. Beta builds are published as GitHub pre-releases, as Modrinth beta versions and to Hangar's Beta channel.
What it does
SessionPulse watches how long each player has been online and sends configurable, non-intrusive health reminders - hydration, posture, eye breaks - at milestones you define. It never kicks anyone by default; enforcement is an optional layer for servers that want structured rest breaks (families, schools, wellness communities).
Features
- Configurable milestones - any number of one-time alerts keyed by minutes played.
- Recurring overtime - optional repeating reminders after a threshold (marathon safety net).
- Optional enforcement - graceful disconnect + rejoin cooldown, disabled by default.
- No reset by rejoining - playtime accumulates across sessions and resets only after a configurable time offline.
- AFK-aware - pauses the session clock when idle (EssentialsX hook or built-in detection).
- Multi-platform - Paper, Spigot and Folia, via FoliaLib + Adventure.
- Rich formatting - MiniMessage on all platforms, action bar, sound, optional title.
- Folia-ready - region-safe schedulers throughout.
Requirements
- Java 21 or newer, on every supported Minecraft version.
- Minecraft 1.20.4 to 1.21.11.
- Paper, Spigot or Folia. All three are tested in CI. Purpur is a Paper fork and is expected to work, but it is not tested.
- EssentialsX is optional. Where it is installed, SessionPulse can use its AFK state; where it is not, a built-in idle timer is used instead.
Install
- Download the jar from GitHub Releases. Pre-releases are listed there too, marked Pre-release. The same builds are published to Modrinth and Hangar.
- Drop it into your server's
plugins/directory and start the server. plugins/SessionPulse/config.ymlis generated on that first start, with every setting at its default - enforcement off, two health milestones, overtime off.- Edit it and run
/spulse reload; nothing in it needs a restart.
To build from source instead:
./gradlew build
The shaded jar is written to build/libs/.
Commands
The command is /spulse, with the alias /sessionpulse.
| Command | Permission | What it does |
|---|---|---|
/spulse time |
sessionpulse.use |
Your own counted playtime and lifetime playtime. |
/spulse time <player> |
sessionpulse.admin |
Another player's playtime, online or offline. |
/spulse top |
sessionpulse.use |
The ten longest lifetime playtimes. |
/spulse reset <player> |
sessionpulse.admin |
Clears a player's counted playtime and any rejoin cooldown. |
/spulse reload |
sessionpulse.admin |
Re-reads config.yml, without a restart. |
Permissions
| Node | Default | Grants |
|---|---|---|
sessionpulse.use |
everyone | /spulse time for yourself, and /spulse top. |
sessionpulse.admin |
operators | /spulse time <player>, reset and reload. Includes sessionpulse.use. |
sessionpulse.exempt |
nobody | No reminders and no enforcement. Playtime is still counted. |
Documentation
- Configuration Reference - every key in
config.yml, its range and default, and what happens to a value that cannot be used. - Admin Guide - commands, permissions, the counted window, AFK detection, enabling enforcement safely, stored data and troubleshooting.
- Changelog - what changed in each version.
Support
- Questions and setup help: Discord.
- Bugs and feature requests: GitHub Issues. Include the plugin version, the server software and version, and the steps that produced the problem.
- Security vulnerabilities: report them privately, as described in the security policy, never in a public issue.
License
Pinned Versions
- B1.20.4–1.21.11
Pages
Members
1
Owner