PlayTimePulse

插件

· 作者 Murk3d

一款轻量级且精确的游玩时间追踪器,支持奖励、图形用户界面(GUI)、预配置和 PlaceholderAPI 功能。

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

最新 1.0.5-SNAPSHOT · 1.21.8 · Bukkit / Paper

一键开服(送7天)

⏱️ PlayTimePulse

一款轻量且精确的 Minecraft 插件,用于追踪玩家游戏时长,与 PlaceholderAPI 无缝集成,并提供带有可领取界面的内置奖励系统。


? 主要功能

  • ⏳ 实时游戏时长追踪 - 准确记录每位玩家在服务器上的在线时长
  • ? 24+ 项游戏时长奖励 - 基于里程碑的奖励,玩家随着游玩时间的增加即可领取
  • ? 分页奖励 GUI - 易于导航的界面,为所有奖励提供多页展示
  • ? 简洁命令 - 为玩家提供直观的 /playtime 命令及管理员工具
  • ? PlaceholderAPI 支持 - 通过占位符与其他流行插件集成
  • ?️ AFK 保护 - 防止玩家利用挂机(AFK)作弊刷取时长
  • ? 高效数据存储 - 使用轻量级扁平文件存储并自动保存
  • ⚡ 高性能 - 经过优化的代码,不会拖慢服务器运行速度
  • ?️ 奖励错误处理 - 即使命令执行失败,也能防止奖励被重复领取
  • ⚙️ 灵活配置 - 轻松自定义所有奖励、GUI 和设置

? 全部功能

  • ⏳ 实时游戏时长追踪(保存的历史时长 + 当前会话时长)
  • ? /playtime 命令:
    • 以 Xd Yh Zm(天/小时/分钟)格式显示游戏时长
    • 打开 GUI 以领取基于游戏时长的奖励
  • ? 奖励系统:
    • 基于里程碑的可领取奖励(当前配置包含 24 项奖励,未来将添加更多)
    • 支持命令执行(因为大部分奖励是通过命令发放的)
    • 通过追踪已领取状态来防止重复领取
    • 支持玩家头颅作为 GUI 图标(例如自定义头颅或玩家骷髅头)
    • 领取奖励时可播放自定义音效
    • 对失败的命令进行错误处理,以防止奖励被恶意刷屏领取
  • ? 分页奖励 GUI:
    • 支持大量奖励的分页功能
    • 可自定义每页显示的槽位数
    • 提供用于翻页的导航按钮
  • ? 导航系统:
    • 上一页/下一页按钮
    • 关闭按钮用于退出 GUI
    • 可自定义导航按钮的材质和名称
    • 可选为导航按钮设置自定义头颅纹理
  • ?️ AFK 保护:
    • 防止玩家利用挂机刷取游戏时长
    • 可配置交互阈值和时间窗口
    • 追踪有意义的玩家交互以验证活动状态
  • ? 完整的 PlaceholderAPI 支持
  • ? bStats 集成,用于匿名使用统计
  • ? 扁平文件存储,支持自动保存
  • ⚙️ 性能优化,易于配置

? 命令

命令 描述 权限
/playtime 显示游戏时长与奖励 GUI playtime.use

| /playtime add <玩家> <小时数>h [<分钟数>m] | 为指定玩家增加游戏时长 | playtime.admin | | /playtime reset <玩家> | 重置指定玩家的游戏时长及已领取的奖励 | playtime.admin |


? PlaceholderAPI 支持

占位符 描述
%playtime_overall_formatted% 总时间(已保存 + 当前),格式如 2d 4h 30m
%playtime_formatted% 仅当前会话,格式化显示
%playtime_overall% 总时间(秒,已保存 + 当前)
%playtime_saved% 仅已保存时间(秒)

| %playtime_current% | 当前在线会话时长(以秒为单位) |


? 未来计划

  • ? 支持格式化文本的渐变色
  • ? 领取奖励时的粒子特效
  • ? 调试模式,便于故障排查
  • ➕ 更多功能即将推出

? 配置

  • config.yml:定义游戏时长里程碑、奖励(命令)、要求、奖励图标/描述以及音效。
    • 每个奖励在领取时都可以通过 claimSound 参数自定义音效
    • 从超过 400 种 Minecraft 音效中选择(例如 entity.player.levelup、block.note_block.pling)
    • 所有音效均以标准音量(1.0)和音调(1.0)播放
    • 可以使用带有 Base64 纹理值的 headId 添加自定义头颅
    • 使用 page 参数指定奖励应显示在哪一页(从 0 开始)
    • 导航按钮可以使用带有 headId 参数的自定义玩家头颅
    • GUI 槽位和每页槽位数均可配置
    • AFK 保护设置:
      • interaction-threshold:时间窗口内所需的最少交互次数
      • time-window-minutes:用于检查交互的时间窗口(分钟)

? 安装

  1. 下载最新版本
  2. 将 .jar 文件放入 /plugins 文件夹
  3. 重启服务器
  4. 配置 config.yml 以定义奖励和要求。
  5. (可选)安装 PlaceholderAPI 以使用占位符

✅ 要求

  • Minecraft:1.21 至 1.21.8
  • Java:21+
  • 服务端:Paper / Pufferfish / Purpur(其他服务端需自行测试)
  • (可选)PlaceholderAPI

? 统计信息

PlayTimePulse 通过 bStats 收集匿名使用统计数据。这有助于我们了解插件的使用情况,并指导未来的开发方向。

您可以在 bStats 查看插件的统计数据。

若要退出数据统计收集,请在 /plugins/bStats/config.yml 文件中设置 enabled: false。


? 支持

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源