PlayTime - 游戏时长查询

Playtime 是一款简单实用的插件，允许玩家查看自己或其他玩家在服务器上的游玩时长。支持查询离线玩家的数据，并显示服务器总时长排行榜。所有显示内容均可通过配置文件自定义。

💡功能特性

• 查看自己的游玩时长与当前会话时长。
• 查看其他在线或离线玩家的游玩时长。
• 显示服务器游玩时长前十名的排行榜。
• 查看服务器的总运行时间（Uptime）。
• 支持通过配置文件完全自定义所有消息和格式。
• 提供丰富的 PlaceholderAPI 占位符，方便在其他插件中使用。

🎮命令与权限

主要命令

命令别名：timeplayed, pt

• /playtime
• 查看自己的游玩时长。
• 所需权限：playtime.check

• /playtime <玩家名>
• 查看指定玩家的游玩时长。
• 所需权限：playtime.checkothers

• /playtime top
• 查看服务器游玩时长前十名排行榜。
• 所需权限：playtime.checktop

• /playtime uptime
• 查看服务器的总运行时间。
• 所需权限：playtime.uptime

• /playtime reload
• 重载插件配置文件。
• 所需权限：playtime.reload

🔧配置说明

配置文件允许你自定义时间单位、消息格式和占位符。

时间单位格式

你可以启用或禁用特定的时间单位，并设置其显示前缀。

time:
  second:
    enabled: true
    prefix: s
  minute:
    enabled: true
    prefix: m
  # ... 以此类推，包含 hour, day, week

消息自定义

所有发送给玩家的消息都可以在 messages 部分进行修改。例如：

• no_permission: 无权限时的提示。
• player: 查看自己数据时的消息。
• playtimetop: 排行榜的标题、条目和页脚。

可用占位符

你可以在配置消息中使用以下插件内置占位符

• %playtime_player% - 玩家名
• %playtime_time% - 总游玩时长
• %playtime_timesjoined% - 加入服务器次数
• %playtime_session% - 当前会话时长
• %playtime_serveruptime% - 服务器运行时间
• %playtime_position% - 玩家在排行榜中的位置
• %playtime_top_#_name% - 排行榜第 # 名的玩家名
• %playtime_top_#_time% - 排行榜第 # 名的时长
• %offlineplayer%, %offlinetime% - 用于查询离线玩家

注意：配置文件也支持任何由 PlaceholderAPI 提供的其他占位符。

✨PlaceholderAPI 支持

如果你安装了 PlaceholderAPI，还可以使用以下占位符：

• %playtime_player%
• %playtime_time%
• %playtime_time_seconds% （仅秒数）
• %playtime_time_minutes% （仅分钟数）
• %playtime_time_hours% （仅小时数）
• %playtime_time_days% （仅天数）
• %playtime_time_weeks% （仅周数）
• %playtime_timesjoined%
• %playtime_serveruptime%
• %playtime_position%
• %playtime_top_#_name%
• %playtime_top_#_time%

❓安装与数据管理

前置需求

• 必需插件：PlaceholderAPI
• 可选插件：若想在 Holographic Displays 中使用本插件占位符，你还需要安装：
• HolographicDisplay
• ProtocolLib
• HolographicExtension

重置玩家数据

若要重置所有玩家的游玩时长数据，请删除主世界文件夹内的 stats 文件夹。

（路径通常为：/world/stats/）

⭐注意事项与支持

• 请确保已安装正确版本的 PlaceholderAPI。
• 如果在 Holographic Displays 中使用占位符，请务必安装所有列出的可选前置插件。
• 若遇到任何问题，请在插件的讨论页面中反馈，而非在评论区内提出，以便开发者更好地提供帮助。