Playtime

插件

· 作者 HBOJ

独立运行的 Paper 游戏时长追踪插件,支持按日、按月、累计以及基于事件的游戏时长统计。

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

最新 1.0.6 · 26.3 · Paper / Purpur

一键开服(送7天)

hPlaytime Banner

Playtime

一款轻量级的 Paper 插件,无需 Essentials、Minecraft 统计功能或其他在线时长插件即可追踪玩家的游玩时间。


它追踪哪些内容?

它会分别追踪多种类型的游玩时间:

类型 描述
今日 当天累计的游玩时间
本月 当月累计的游玩时间
总计 hPlaytime 记录的总游玩时间
活动 具有独立日志的临时游玩时间竞赛

本插件从安装时刻开始记录数据。它不会导入 Essentials 的数据,也不使用 Minecraft 自带的统计功能。


命令

玩家

命令 权限 描述
/playtime hplaytime.use 查看自己的游玩时间
/pt hplaytime.use /playtime 的别名
/playtime <player> hplaytime.others 查看其他玩家的游玩时间
/playtime top hplaytime.use 显示历史总游玩时间前 10 名排行榜
/playtime topday hplaytime.use 显示日游玩时间前 10 名排行榜
/playtime topmonth hplaytime.use 显示月游玩时间前 10 名排行榜

管理员

命令 权限 描述
/hplaytime reload hplaytime.reload 重载配置文件、语言文件、存储设置、AFK 设置和格式设置
/hplaytime reset <player> hplaytime.reset 重置指定玩家的主要游玩时间
/hplaytime resetall hplaytime.resetall 重置所有玩家的主要游玩时间

活动

命令 权限 描述
/playtime event create <name> <duration> hplaytime.event.create 创建一个游玩时间活动
/playtime start <name> hplaytime.event.start 启动一个全新的活动
/playtime event end <name> hplaytime.event.end 结束一个活动并写入日志
/playtime event delete <name> hplaytime.event.delete 删除活动的跟踪文件
/event list hplaytime.event.list 列出活动

示例:

/playtime event create weekend 24h
/playtime start weekend

支持的时间长度示例:

24h
7d
1h30m
45m
PlaceholderAPI

PlaceholderAPI

如果安装了 PlaceholderAPI,hPlaytime 会自动注册 %hplaytime_...% 占位符。

占位符 含义
%hplaytime_today% 今日格式化后的游戏时长
%hplaytime_month% 本月格式化后的游戏时长
%hplaytime_alltime% 历史总计格式化后的游戏时长
%hplaytime_today_seconds% 今日游戏时长(整数秒)
%hplaytime_month_seconds% 本月游戏时长(整数秒)
%hplaytime_alltime_seconds% 历史总计游戏时长(整数秒)
%hplaytime_today_millis% 今日游戏时长(毫秒)
%hplaytime_month_millis% 本月游戏时长(毫秒)
%hplaytime_alltime_millis% 历史总计游戏时长(毫秒)
%hplaytime_player% 存储的玩家名称
%hplaytime_lastseen% “最后上线”文本,显示为 online now(当前在线)或 unknown(未知)

数字后缀还支持 _minutes、_hours 和 _days。daily 是 today 的别名,monthly 是 month 的别名,total 是 alltime 的别名。

对于 ajLeaderboards,按数值型占位符排序并显示格式化后的值。

占位符 含义
%hplaytime_alltime_seconds% 用于排序的数值
%hplaytime_alltime% 用于显示的格式化游戏时长

也支持直接获取排名靠前的占位符。

占位符 含义
%hplaytime_top_alltime_1_name% 历史排名第 1 的玩家名称
%hplaytime_top_alltime_1_time% 历史排名第 1 的格式化游戏时长
%hplaytime_top_today_1_name% 今日排名第 1 的玩家名称
%hplaytime_top_month_1_time% 本月排名第 1 的格式化游戏时长

顶级排名的占位符格式为 %hplaytime_top_<today|month|alltime>_<rank>_<name|uuid|time|millis|seconds|minutes|hours|days>%。

权限
权限 默认 描述
hplaytime.use 所有人 使用 /playtime 命令
hplaytime.others OP 查看其他玩家的游戏时长
hplaytime.reload OP 重载 hPlaytime
hplaytime.reset OP 重置单个玩家的主要游戏时长
hplaytime.resetall OP 重置所有主要游戏时长
hplaytime.event.create OP 创建游戏时长活动
hplaytime.event.start OP 开始游戏时长活动
hplaytime.event.end OP 结束游戏时长活动
hplaytime.event.delete OP 删除活动跟踪文件
hplaytime.event.list OP 列出活动

功能

  • 独立游戏时长追踪
  • 每日、每月及历史总计统计
  • 临时游戏时长活动
  • 默认使用本地 YAML 存储
  • 可选 MySQL 存储
  • 内置挂机保护
  • 不计入游戏时长的挂机世界
  • 可选的最后上线信息显示
  • 可配置日期、时区和时间格式
  • 完全可编辑的 lang.yml
  • 玩家与全局重置命令
  • 活动获胜者广播
  • 永久保存的活动结果日志
  • 简单的文本命令,无需 GUI
要求 版本
服务器软件 Paper 1.19+
Java Java 21+

MySQL 是可选的。hPlaytime 默认使用本地 YAML 存储。


安装

  1. 下载最新的 jar 文件。
  2. 将其放入服务器的 plugins 文件夹中。
  3. 重启服务器。
  4. 编辑 plugins/hPlaytime/ 下生成的文件。
  5. 修改完成后,运行 /hplaytime reload。

插件文件

hPlaytime 会在你服务器的 plugins 目录内创建自己的文件夹。

路径 用途
config.yml 存储、格式设置、AFK(挂机)、AFK 世界以及保存设置
lang.yml 可编辑的插件消息
data/ 本地玩家游戏时长数据文件
events/ 活跃活动追踪文件
event-logs/ 已保存的活动结果日志
存储设置

hPlaytime 支持本地 YAML 存储和 MySQL 存储。

默认启用本地存储:

storage:
  type: local

本地玩家数据保存在此处:

plugins/hPlaytime/data/<uuid>.yml

这是最简单的选项,推荐用于单服务器环境。

要使用 MySQL:

storage:
  type: mysql

  mysql:
    host: localhost
    port: 3306
    database: minecraft
    username: root
    password: ""
    use-ssl: false
    table-prefix: hplaytime_

hPlaytime 会自动创建所需的 MySQL 表。

主要游戏时长可以使用 MySQL,但活动追踪目前仍基于本地文件。

AFK(挂机)保护

hPlaytime 包含其自身的 AFK 系统,不依赖 Essentials 的 AFK 功能。

afk:
  enabled: true
  timeout-seconds: 300

  worlds:
    - afk

当玩家处于非活跃状态时,新的游戏时长将停止计算,直到他们移动、交互或执行命令为止。

在配置了 AFK 世界的玩家不会获得:

  • 主要游戏时长
  • 活动游戏时长
日期、时间和最后上线格式化

日期键和时间区可在 config.yml 中进行配置。

date-format:
  timezone: system
  daily-pattern: yyyy-MM-dd
  monthly-pattern: yyyy-MM

使用 timezone: system 表示使用服务器机器的时区,或使用 Java 时区 ID:

timezone: America/Chicago

时间输出也可以自定义:

time-format:
  style: compact
  show-seconds: true
  zero: 0s

紧凑输出示例:

1d 4h 22m

长格式输出示例:

1 day 4 hours 22 minutes

可以启用、禁用或重新格式化“最后上线”输出:

last-seen:
  enabled: true
  pattern: yyyy-MM-dd HH:mm:ss z
语言文件

所有消息均可在以下位置编辑:

plugins/hPlaytime/lang.yml

消息支持 & 颜色代码。

常用占位符:

占位符 描述
%prefix% lang.yml 中配置的前缀
%player% 玩家名称
%today% 今日游戏时长
%month% 本月游戏时长
%alltime% 累计总游戏时长
%lastseen% 最后上线状态
%event% 活动名称
%duration% 活动持续时间
%time% 格式化后的时间
%events% 活动列表

编辑完 lang.yml 后,请运行:

/hplaytime reload

重要说明

  • hPlaytime 在安装后即开始追踪游戏时长。
  • 它不会导入 Essentials 的游戏时长数据。
  • 它不使用 Minecraft 统计数据来计算累计总时长。
  • 重置命令仅影响主要游戏时长。
  • 重置命令不会删除活动日志。
  • AFK 超时适用于主要游戏时长和活动游戏时长。
  • AFK 世界适用于主要游戏时长和活动游戏时长。
  • 即使活动已删除,活动日志仍会保留。
  • 即使启用了 MySQL,活动追踪目前仍基于本地文件。

支持

如果你发现 bug 或有建议,请在 GitHub 上提交 Issue,并提供你的服务器版本、插件版本以及相关控制台错误信息。

该插件正在积极维护中,但新功能的添加会比较谨慎,以保持其轻量级特性。


作者

  • HBOJ

许可证

  • ARR License

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源