我的世界

PlayTimeManager 玩家在线时长统计插件

LT-YHC

2026-08-14 15:23:22 · 更新于 2026-08-23 17:27:58 · 15 浏览 · 2 回复

PlayTimeManager

一款专为 Paper / Purpur 服务端设计的高性能玩家在线时长追踪与自动化奖励插件。支持全版本（1.19 – 26.2），内置 SQLite 存储、HikariCP 连接池、内存缓存、AFK 检测、目标系统、连续登录奖励、排行榜、LuckPerms 联动与 PlaceholderAPI 深度集成，并通过直观的 GUI 让管理员零代码搭建玩家成长体系。
作者：TheGaBr0（TheGabro）
许可证：GPL-3.0-or-later（免费、开源）
当前版本：v3.6.5
下载量：5000+
官网 / Wiki：wiki.playtimemanager.com
GitHub：github.com/TheGaBr0/PlayTimeManager
下载渠道：Modrinth / Hangar / SpigotMC

概述

PlayTimeManager（简称 PTM）解决的问题很明确：精准追踪每个玩家在服务器上的累计在线时长，并基于时长自动触发奖励、晋升、称号等互动机制。它不是简单地读取服务端自带的 stat.play_one_minute，而是在此基础上叠加独立的"人工时长"字段，支持管理员手动增减、跨版本迁移、防篡改校验，确保数据长期稳定。
核心优势
专为 Paper 优化：不再支持 Spigot，充分利用 Paper 的异步 API 与性能优势
双模式存储：默认 SQLite（零配置即用），可一键迁移至 MySQL / MariaDB / PostgreSQL
AFK 智能识别：原生支持 EssentialsX、Purpur 内置、AFKPlus、JetsAntiAFKPro，还可通过 PAPI 占位符对接任意 AFK 插件
两大奖励系统：Goals（时长目标） + Join Streak（连续登录），支持消息、命令、权限、声效、物品、GUI 图标六种奖励类型
完整 GUI 管理：目标创建、奖励配置、连续登录查看、统计面板全部图形化，无需手编 YAML
LuckPerms 联动：自动给达标玩家添加权限组、前缀，排行榜直接显示 LuckPerms 前缀
PlaceholderAPI 深度集成：20+ 内置占位符，支持嵌套占位符、自定义时间格式、离线玩家查询
隐身兼容：v3.6.5 新增 Vanish 隐身模式，隐身玩家不会通过 PTM 占位符或 GUI 泄露在线状态
自动更新与备份：升级时自动备份整个插件文件夹，配置文件自动迁移，数据向下兼容至 v3.0.4
高性能：内存缓存 + HikariCP 连接池 + 全异步数据库读写，对服务器 TPS 影响极低

版本与兼容性
支持的服务端与 MC 版本

| 服务端 | 最低 MC 版本 | 最高 MC 版本 | 备注 |
| :--- | :--- | :--- | :--- |
| Paper | 1.19 | 26.2 | 首选，性能最佳 |
| Purpur | 1.19 | 26.2 | 完全兼容，额外支持 Purpur AFK 检测 |
| Folia | 1.19 | 26.2 | 区域化线程调度兼容 |
⚠️ Spigot 已不再受支持。插件在 Spigot 上可能无法加载或运行不稳定，请迁移至 Paper 或 Purpur。
Java 版本要求
Java 17 或更高版本
依赖插件（可选）

| 插件 | 用途 | 是否必须 |
| :--- | :--- | :--- |
| PlaceholderAPI | 解锁全部 PAPI 占位符功能 | 推荐 |
| LuckPerms | 权限组自动晋升、前缀显示 | 推荐 |
| EssentialsX | AFK 检测数据源 | 可选 |
| AFKPlus | AFK 检测数据源 | 可选 |
| JetsAntiAFKPro | AFK 检测数据源 | 可选 |
| ProtocolLib | 部分 GUI 功能依赖 | 可选 |
离线模式 / 正版模式
两种模式均完全支持
离线模式玩家昵称大小写敏感
正版模式玩家昵称查找不区分大小写（v3.6.4+）
UUID 映射系统防止重复数据

/playtimemigration start
/playtimemigration status
/playtimemigration cancel

迁移在下次重启时自动执行，执行前自动备份全部数据。

/playtime add Steve 1y 30d 2h 10m 5s
/playtime set Alex 500m
/playtime remove Bob 1d12h

可用单位：s（秒）、m（分）、h（时）、d（天）、w（周）、mo（月，默认 30 天）、y（年）、mc（MC 天，1 MC 天 = 20 分钟）

%PTM_rank_%player_name%% -> 用 PAPI Player 扩展解析出的玩家名的排行
%PTM_playtime_%vault_eco_balance%% -> 结合经济数据做条件判断
自定义时间格式

在 Customization/PlaytimeFormats/ 创建 YAML 后，通过冒号追加格式名调用：

%PTM_playtime:myformat%
%PTM_playtime_:myformat%

配置文件说明
目录结构

plugins/PlayTimeManager/
├── config.yml # 主配置文件
├── Customization/
│ ├── Commands/
│ │ └── commands-config.yml # 命令输出文本翻译
│ ├── GUIs/
│ │ └── GUIs-config.yml # 所有 GUI 的布局与文本
│ └── PlaytimeFormats/
│ └── default.yml # 自定义时间格式
├── Goals/ # 每个目标一个 YAML 文件
│ ├── 10h-reward.yml
│ └── daily-login.yml
├── JoinStreaks/ # 每个连击奖励一个 YAML 文件
│ └── 7day-streak.yml
└── PlayTimeManager.db # SQLite 数据库文件
config.yml 关键字段
---- 基础设置 ----
prefix: "&8[&bPTM&8] &r" # 插件所有消息的前缀
datetime-format: "dd/MM/yyyy HH:mm" # 日期显示格式
month-value-in-days: 30 # 1 个月等于多少天（用于 mo 单位）
---- 消息定制 ----
playtime-self-message: "&a你的在线时长: &6%PLAYTIME%"
playtime-others-message: "&a%PREFIX%%PLAYER_NAME%&a的在线时长: &6%PLAYTIME%"
placeholders:
enable-errors: false # false 时显示 default-message 而非报错
default-message: "N/A"
not-in-leaderboard-message: "未上榜"
playtime-leaderboard-blacklist: [] # 黑名单 UUID 列表
---- AFK 检测 ----
afk-detection-plugin: "essentialsx" # none/essentialsx/purpur/afkplus/jetsantiafkpro
afk-placeholder: "%essentials_afk%" # 当上方设为 none 时使用的 PAPI 占位符
ignore-afk-time: true # AFK 时间不计入总时长
---- 排行榜 ----
playtimetop:
leaderboard-format: "&e#%POSITION% &r%PREFIX%%PLAYER_NAME% &7- &b%PLAYTIME%"
page-size: 10
---- 隐身模式 ----
vanish-stealth-mode: true # v3.6.5+ 隐藏隐身玩家
---- 数据库（迁移后自动写入） ----
database:
type: "sqlite" # sqlite / mysql / mariadb / postgresql
MySQL / MariaDB / PostgreSQL 额外字段：
address: "127.0.0.1:3306"
database: "playtimemanager"
username: "root"
password: "yourpassword"
table-prefix: "ptm_"
---- 缓存 ----
cache:
enabled: true
reset-interval-minutes: 30 # 防内存泄漏的自动重置间隔
目标 YAML 示例（Goals/10h-reward.yml）

name: "10h-reward"
enabled: true
repeatable: true
requirements:
playtime: "10h"
permission: ""
placeholder-condition: ""
rewards:
messages:
- "&a恭喜！你已达到 10 小时在线时长！"
commands:
- "console:give %PLAYER_NAME% diamond 5"
permissions:
- "vip.basic"
sound: "ENTITY_PLAYER_LEVELUP"
连续登录 YAML 示例（JoinStreaks/7day-streak.yml）

name: "7day-streak"
enabled: true
required-joins: 7
cron-expression: "0 0 " # 每天凌晨检查
loop: true # 达到后循环回到第 1 天
reward-message: "&b连续登录 7 天！获得特殊称号！"
reward-commands:
"console:lp user %PLAYER_NAME% parent add streak7"
reward-icon:
material: "DIAMOND"
enchantment-glint: true

安装步骤
第一步：环境检查
确认服务端为 Paper 或 Purpur（Spigot 不支持）
确认 Java 版本 >= 17
确认 MC 版本在 1.19 – 26.2 范围内
第二步：下载与安装
从 Modrinth / Hangar / SpigotMC 下载 PlayTimeManager-3.6.5.jar
将 jar 文件放入服务端的 plugins/ 目录
如需 PAPI 占位符功能，同时安装 PlaceholderAPI 并运行 /papi ecloud download Player + /papi reload
如需 LuckPerms 联动，确保 LuckPerms 已安装并正常运行
第三步：首次启动
启动（或重启）服务器
插件会自动创建 plugins/PlayTimeManager/ 目录及默认配置文件
控制台应出现类似日志：

[PlayTimeManager] Plugin enabled successfully! Using SQLite for data storage.
第四步：基础配置
打开 config.yml，按需修改 prefix、datetime-format、afk-detection-plugin 等
如需切换数据库，修改 database 段落并运行 /playtimemigration start mysql
执行 /playtimereload 或重启服务器使配置生效
第五步：创建第一个目标
在游戏内执行 /playtimegoal 打开 GUI
点击 "Create New Goal" 按钮
设置名称、时长要求、奖励内容
保存后目标立即生效
升级迁移
从 v3.0.4 及以后版本升级：直接替换 jar，重启即可，插件自动备份并迁移配置
从 v3.0.4 之前版本升级：需先升级到 v3.1 过渡版，再升至最新版
升级前插件会自动备份整个 PlayTimeManager 文件夹，无需手动备份

PlayTimeManager 玩家在线时长统计插件

评论 (0)

{{title}}

PlayTimeManager 玩家在线时长统计插件

评论 (0)

打赏支持

打赏记录

举报内容

编辑版本

{{title}}