PlayTime - 游玩时长查询

PlayTime 是一款适用于 Minecraft 服务器的插件，可帮助玩家轻松追踪游戏时长。玩家不仅可以查看自己的在线时长，也可以查询其他玩家的游玩时间。

⭐功能特色

• 玩家游戏时长追踪
• 记录并存储每位玩家的总游戏时长。
• 玩家可随时查看自己的游戏时长统计，更直观地了解自己在服务器中的活跃度。

• 在线时长排行榜
• 自动生成并更新基于游戏时长的顶级玩家列表。
• 排行榜支持分页显示，对大型社区也更加友好、便于浏览。

• 可自定义命令
• 插件中的命令可在 config.yml 中进行配置，服务器管理员可以启用或禁用某些功能，或修改权限节点。
• 所有命令都带有权限检查，确保只有被授权的玩家才能访问排行榜等功能。

• 友好的消息提示
• 聊天消息支持颜色显示，使用 Minecraft 内置聊天颜色，提高可读性与互动体验。
• 对无效输入会提供反馈，确保玩家在使用插件时能立即获得清晰的响应。

• 可配置设置
• 服务器管理员可直接在插件配置文件中调整命令权限、分页大小和显示格式等设置。
• 这种灵活性使插件能够适配不同类型服务器的需求。

• 翻译消息
• 可根据用户的语言设置自动切换语言。
• 可在配置文件中设置控制台语言。
• 目前已支持 8 种翻译语言，并且还在持续增加中。

✨评分支持

• 希望你会喜欢这款插件。
• 如果你觉得它实用且有趣，欢迎抽空给出 5 星评价。
• 你的积极反馈不仅能激励作者持续改进插件，也能帮助更多人发现它。
• 感谢你的支持！

💡Bug 反馈与建议

• 你的反馈对 PlayTime 的持续开发非常重要。
• 如果你有新功能建议、发现了 Bug，或有任何一般性问题，欢迎随时联系作者。

🎮联系方式

• My website : https://www.ryan-simms.com/
• Discord : https://discordapp.com/users/208345026340585473/

🔧特别感谢

特别感谢来自 Koinotita Gaming 的玩家，尤其是：

• Siphayeur
• schildkroet05
• sylfori (Chaos)
• L.E.S.F

❓未来更新计划

• Use of MySQL database option
• Add a GUI menu for players

⭐捐赠

• 所有捐赠都将不胜感激。
• 但捐赠完全不是强制性的。

祝你游戏愉快！

本插件可用于查看玩家游玩时长、排行榜以及奖励进度，并提供灵活的配置项与占位符支持。

💡用法

查看个人游玩时长

• 玩家可以执行简单命令来查看自己的总游玩时长。
• 输出会以格式化形式显示时长，包含月、天、小时、分钟和秒。

查看最高游玩时长排行

• 排行榜命令会显示按总游玩时长排序的分页玩家列表。
• 玩家可以通过附加命令参数切换页面。

命令语法

• /pt - 显示你的游玩时长
• /pt [username] - 显示指定用户的游玩时长
• /pttop [page] - 显示游玩时长排行榜；可选指定页码以查看不同分页内容
• /ptrewards [username] - 显示已获得的奖励，以及达成其他奖励还需要的时间
• /ptreload - 拥有相应权限的服务器管理员可在不重启服务器的情况下重载插件配置文件

🎮配置

# General configuration 
lang: "en"
# Set to your desired console language - see list in lang folder

rewards:
  enabled: true
  # Master toggle to enable/disable the rewards system

  broadcast:
    chat: true
    # Whether to broadcast messages to the server when rewards are given

    discord: false
    # Whether to broadcast messages to the Discord server-chat when rewards are given (requires DiscordSRV or EssentialsXDiscord)

  reward-cooldown: 60
  # Minimum time (in seconds) between processing rewards for the same player

playtime:
  auto-save-interval: 300
  # How often (in seconds) playtime data is auto-saved to the database

  page-size: 10
  # How many players per page in /pttop

track-afk:
  enabled: false
  # If true, afk-time is recorded causing play time to be paused when user is AFK

  afk-detection: 300000
  # Time (in miliseconds) until player becomes AFK - default is 5 minutes

commands:
  pt:
    enabled: true
    # Enable/disable the /pt (playtime) command

  pttop:
    enabled: true
    # Enable/disable the /pttop command

  ptreload:
    enabled: true
    # Enable/disable the /ptreload command

logging:
  debug: false
  # Enable debug logging

  reward-claims: true
  # Log every reward claim to the server console

# -------------------------------------------------------------------------------- #
# Color configuration - use Minecraft chat codes (1.16 or below) e.g. &c or hex codes e.g. #FF5555 (1.16+)

color:
  integer: "#FFFFFF"
  # Numbers used in total play time

  interval: "#55FF55"
  # Words following integer e.g. month

  header: "#FFAA00"
  # Color of the top bar in /pttop

  footer: "#FFAA00"
  # Color of the bottom bar in /pttop

  list-item: "#FFFFFF"
  # List number on /pttop

  error: "#FF5555"
  # Any error message

  success: "#55FF55"
  # Any success message

  user: "#FFFFFF"
  # Any username

  earned: "#FFFFFF"
  # Reward message e.g. "...has earned"

  reward: "#FFFFFF"
  # Name of reward
# -------------------------------------------------------------------------------- #

配置说明

• lang
• 设置控制台语言，具体可选项请查看 lang 文件夹中的列表。
• rewards.enabled
• 奖励系统总开关，可启用或禁用奖励功能。
• rewards.broadcast.chat
• 玩家获得奖励时，是否向服务器内广播消息。
• rewards.broadcast.discord
• 玩家获得奖励时，是否向 Discord 服务器聊天频道广播消息。
• 需要 DiscordSRV 或 EssentialsXDiscord。
• rewards.reward-cooldown
• 同一玩家两次奖励处理之间的最小间隔时间，单位为秒。
• playtime.auto-save-interval
• 游玩时长数据自动保存到数据库的间隔时间，单位为秒。
• playtime.page-size
• /pttop 每页显示的玩家数量。
• track-afk.enabled
• 若为 true，将记录 AFK 时间，并在玩家 AFK 时暂停游玩时长统计。
• track-afk.afk-detection
• 玩家被判定为 AFK 所需的时间，单位为毫秒，默认 5 分钟。
• commands.pt.enabled
• 启用或禁用 /pt 命令。
• commands.pttop.enabled
• 启用或禁用 /pttop 命令。
• commands.ptreload.enabled
• 启用或禁用 /ptreload 命令。
• logging.debug
• 启用调试日志。
• logging.reward-claims
• 将每次奖励领取记录到服务器控制台。
• color.*
• 颜色配置。可使用 Minecraft 聊天颜色代码（1.16 及以下），例如 &c，或十六进制颜色代码，例如 #FF5555（1.16+）。

✨占位符

当前可用占位符

• %playtime_total% - 显示完整游玩时长
• %playtime_in_months% - 仅显示月数
• %playtime_in_days% - 仅显示天数
• %playtime_in_hours% - 仅显示小时数
• %playtime_in_minutes% - 仅显示分钟数
• %playtime_in_seconds% - 仅显示秒数
• %playtime_join_date% - 显示最初加入日期

🔧备注

• Discord 广播功能需要 DiscordSRV 或 EssentialsXDiscord。
• 颜色配置支持传统 Minecraft 颜色代码与十六进制颜色代码。
• AFK 追踪默认关闭。