PlayTime » 1.17 - 1.21.11 - PlayTime - 游戏时长统计与奖励

PlayTime 是一款高品质的在线时长追踪插件，完全免费。它能以极高的精度追踪玩家的游戏时长，提供排行榜查看、可配置的奖励解锁功能，并通过多个精美且完全可配置的 GUI 界面进行管理。该插件专为从小型服务器到大型网络的各种规模设计，全面支持 BungeeCord 和 Velocity，并借助 MySQL 实现跨服务器同步——只需在每个子服上安装，启用网络同步即可。

🎮核心功能

• 精确追踪玩家的总在线时长、会话时长和每日时长。
• 智能 AFK 检测，区分活跃时间与挂机时间。
• 支持可配置的在线时长奖励系统。
• 提供美观、可自定义的 GUI 界面来查看时长、排行榜和奖励。
• 内置跨服同步功能，适用于 BungeeCord 和 Velocity 网络。
• 提供丰富的 PlaceholderAPI 变量，用于在其他插件中显示数据。
• 支持查看历史数据（日/月）和连胜记录。

🔧命令与别名

主命令为 /playtime，您也可以使用以下快捷别名：

• pt
• playertime
• onlinetime
• timeplayed
• ot

子命令说明

• /playtime - 查看自己的在线时长。
• /playtime <玩家名> - 查看指定玩家的在线时长。
• /playtime top - 打开总时长排行榜 GUI。
• /playtime topday - 查看今日时长排行榜。
• /playtime topmonth - 查看本月时长排行榜。
• /playtime rewards - 打开奖励领取 GUI。
• /playtime streaks - 查看连胜记录。
• /playtime resetplaytime <玩家名> - 重置指定玩家的在线时长。
• /playtime clearrewards <玩家名> - 清除指定玩家的奖励领取记录。
• /playtime reload - 重载插件配置。

✨权限列表

• playtime.use - 允许玩家使用 /playtime 查看自己的时长。
• playtime.viewother - 允许通过 /playtime <玩家名> 查看他人时长。
• playtime.top - 允许打开 /playtime top GUI。
• playtime.toprange - 允许使用 /playtime topday 和 /playtime topmonth。
• playtime.rewards - 允许通过 /playtime rewards 打开奖励 GUI。
• playtime.streaks - 允许通过 /playtime streaks 查看连胜。
• playtime.resetplaytime - 允许使用 /playtime resetplaytime <玩家名>。
• playtime.reload - 允许重载插件。
• playtime.clearrewards - 允许使用 /playtime clearrewards 子命令。
• playtime.update - 在插件有更新时，于玩家加入时发送通知（如果启用）。
• playtime.top.exclude - 使玩家不会出现在任何时长排行榜和 GUI 中。

💡AFK 检测机制

PlayTime 通过追踪玩家的最后活动时间来判断是否处于 AFK 状态。

活动判定

当玩家执行以下任何操作时，会被标记为活跃：

• 移动
• 环顾四周（转动视角）
• 与方块或实体交互
• 在聊天栏发言
• 执行任何命令

AFK 判定

如果玩家在配置的 AFK 阈值时间内未进行任何上述活动，则会被标记为 AFK。一旦他们再次变得活跃，AFK 状态即被解除。

⭐PlaceholderAPI 变量

PlayTime 提供了大量 PlaceholderAPI 变量，用于在聊天、记分板或其他插件中灵活显示数据。变量主要分为以下几类：

查看者总时长

• %playtime_playtime% - 格式化后的总时长。
• %playtime_playtime_seconds% - 总秒数（原始数据）。
• %playtime_playtime_weeks%, %playtime_playtime_days%, %playtime_playtime_hours%, %playtime_playtime_minutes% - 带单位的周/天/时/分。
• 对应的 _no_label 变量仅返回数字。

查看者服务器时长

• %playtime_server_playtime% - 在当前后端服务器的格式化时长。
• %playtime_server_playtime_seconds% - 在当前后端服务器的秒数。
• 同样提供带单位和不带单位的周/天/时/分变量。

查看者 AFK 与活跃时长

• %playtime_playtime_afk% - 格式化后的 AFK 总时长。
• %playtime_playtime_active% - 格式化后的活跃总时长。
• 均提供秒数、带单位和不带单位的时/分等详细变量。

会话与每日时长

• %playtime_session% - 本次游戏会话的格式化时长。
• %playtime_daily% - 今日游戏时长的格式化总时长。
• 均提供详细的秒数、天、时、分等变量。

奖励进度变量

针对每个配置的奖励键（<key>），提供以下变量：

• %playtime_daily_<key>_current% - 今日当前进度（格式化）。
• %playtime_daily_<key>_required% - 今日所需时长（格式化）。
• %playtime_daily_<key>_remaining% - 今日剩余时长（格式化）。
• %playtime_daily_<key>_progress_percent% - 今日进度百分比（0-100%）。
• 同样支持 session_（会话）、unique_（唯一）和 constant_（恒定周期）类型的奖励。

连胜变量

针对每个配置的连胜键（<key>），提供以下变量：

• %playtime_streak_<key>_days% - 完成该连胜所需的总天数。
• %playtime_streak_<key>_duration% - 所需的每日时长（短格式，如“1h”）。
• %playtime_streak_<key>_count% - 当前连胜计数。
• %playtime_streak_<key>_claimed_today% - 今日是否已领取连胜奖励（true/false）。

历史数据

• %playtime_day_<yyyy-MM-dd>% - 指定日期的格式化时长。
• %playtime_month_<yyyy-MM>% - 指定月份的格式化时长。
• 均提供对应的秒数变量。

历史排行榜

• %playtime_top_day_<排名>_<yyyy-MM-dd>_name% - 指定日期排名上的玩家用户名。
• %playtime_top_day_<排名>_<yyyy-MM-dd>_time% - 该排名玩家在当日的格式化时长。
• 月份排行榜变量格式为 %playtime_top_month_<排名>_<yyyy-MM>_name% 等。

指定玩家查询

• %playtime_<玩家名>_playtime% - 指定玩家的格式化总时长。
• %playtime_<玩家名>_server_playtime% - 指定玩家在当前后端服务器的格式化时长。

🔧配置文件

PlayTime 的主要配置文件如下，您可以在 plugins/PlayTime/ 目录下找到并修改它们：

• config.yml - 主配置文件，包含插件核心设置、数据库、AFK、GUI 等选项。
• messages.yml - 消息文本文件，您可以在此自定义插件显示的所有提示信息。

❓支持与帮助

获取支持的最快方式是加入我们的资源 Discord 服务器。您可以在那里提问、报告问题或与其他用户交流。

» https://discord.gg/2vUqykD

重要提示

如果您遇到任何问题，请不要留下差评。请直接通过私信（PM）或在插件的讨论区留言联系我们，我们会尽力为您解决。您的理解和正面评价对我们非常重要！