属于 Ninja6-MC 插件套件的一部分。
状态
预发布。 1.0.0 之前的所有版本均为预发布版本,1.0.0 将是首个稳定版本。在此之前,配置键和行为可能在不同版本间发生变化;升级前请阅读更新日志。
Alpha 构建作为 GitHub 预发布版本、Modrinth alpha 版本以及 Hangar 的 Alpha 频道发布(Hangar 默认隐藏该频道)。Beta 构建作为 GitHub 预发布版本、Modrinth beta 版本以及 Hangar 的 Beta 频道发布。
功能说明
SessionPulse 会监控每位玩家的在线时长,并在你设定的里程碑时刻发送可配置的、非侵入性的健康提醒——包括补水、调整姿势和眼部休息。它默认不会踢出任何玩家;强制执行功能是可选的附加层,专为希望实现结构化休息时间的服务器(如家庭、学校或健康社区)设计。
特性
- 可配置的里程碑 - 支持任意数量的基于游戏分钟数的一次性警报。
- 循环超时提醒 - 超过阈值后可选的重复提醒(马拉松模式的安全网)。
- 可选的强制执行 - 优雅断开连接 + 重新加入冷却时间,默认禁用。
- 重连不重置 - 游戏时长跨会话累积,仅在离线达到可配置时间后才重置。
- AFK 感知 - 空闲时暂停会话计时器(通过 EssentialsX 钩子或内置检测实现)。
- 多平台支持 - Paper、Spigot 和 Folia,基于 FoliaLib + Adventure。
- 丰富的格式支持 - 所有平台均支持 MiniMessage,包含操作栏、音效及可选标题。
- Folia 就绪 - 全程使用区域安全调度器。
要求
- Java 21 或更高版本,适用于所有受支持的 Minecraft 版本。
- Minecraft 1.20.4 至 1.21.11。
- Paper、Spigot 或 Folia。 三种核心均在 CI 中经过测试。Purpur 是 Paper 的分支,预计可以正常工作,但未经过测试。
- EssentialsX 为可选依赖。如果已安装 EssentialsX,SessionPulse 将使用其 AFK 状态;否则将使用内置的空闲计时器。
安装
- 从 GitHub Releases 下载 jar 文件。预发布版本也列在此处,标记为 Pre-release。相同的构建也会发布到 Modrinth 和 Hangar。
- 将其放入服务器的
plugins/ 目录并启动服务器。
- 首次启动时会生成
plugins/SessionPulse/config.yml,所有设置均为默认值——强制执行关闭,两个健康里程碑,超时提醒关闭。
- 编辑配置文件并运行
/spulse reload;无需重启即可生效。
若要从源代码构建:
./gradlew build
阴影 jar 文件将写入 build/libs/。
命令
命令为 /spulse,别名为 /sessionpulse。
| 命令 |
权限节点 |
功能说明 |
/spulse time |
sessionpulse.use |
查看自己的累计游戏时间和总游戏时间。 |
/spulse time <player> |
sessionpulse.admin |
查看其他玩家的游戏时间,无论在线或离线。 |
/spulse top |
sessionpulse.use |
查看总游戏时间最长的十位玩家。 |
/spulse reset <player> |
sessionpulse.admin |
清除指定玩家的游戏时间和重新加入冷却时间。 |
/spulse reload |
sessionpulse.admin |
重新读取 config.yml,无需重启服务器。 |
权限
| 节点 |
默认分配 |
授予权限 |
sessionpulse.use |
所有人 |
允许使用 /spulse time 查看自身数据,以及 /spulse top。 |
sessionpulse.admin |
操作员 |
允许使用 /spulse time <player>、reset 和 reload。包含 sessionpulse.use 权限。 |
sessionpulse.exempt |
无 |
不接收任何提醒且不执行强制断开。但仍会计入游戏时间。 |
文档
- 配置参考 -
config.yml 中的每个键、取值范围、默认值,以及无法使用的值会发生什么。
- 管理员指南 - 命令、权限、计算窗口、AFK 检测、安全启用强制执行、存储的数据及故障排除。
- 更新日志 - 每个版本的变更内容。
支持
- 问题与安装帮助: Discord。
- 漏洞与功能请求:
GitHub Issues。请包含插件版本、服务器软件及版本,以及复现问题的步骤。
- 安全漏洞: 请按照 安全策略 中的描述私下报告,切勿在公开 issue 中报告。
许可证
GNU General Public License v3.0。
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.yml is 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
GNU General Public License v3.0.
评论 0
登录后参与评分
还没有评论,来抢沙发吧