SessionPulse

插件

· 作者 Bharath

Paper/Folia/Spigot:温和的在线时长提醒、里程碑提示、AFK 感知追踪,以及可选的会话时长限制。

0 本站下载 0 关注 更新于 1 周前

最新 0.2.0-beta.2 · 26.3 · Paper / Spigot

一键开服(送7天)

属于 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 状态;否则将使用内置的空闲计时器。

安装

  1. 从 GitHub Releases 下载 jar 文件。预发布版本也列在此处,标记为 Pre-release。相同的构建也会发布到 Modrinth 和 Hangar。
  2. 将其放入服务器的 plugins/ 目录并启动服务器。
  3. 首次启动时会生成 plugins/SessionPulse/config.yml,所有设置均为默认值——强制执行关闭,两个健康里程碑,超时提醒关闭。
  4. 编辑配置文件并运行 /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。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源