TDR Playtime - 游戏时长奖励 MySQL支持

TDRPlaytime 是一款用于追踪玩家在服务器上游戏时长的插件。它不仅能够精确记录时间，还通过丰富的奖励机制让玩家乐于在服务器上投入更多时间，同时其配置过程简单直观，易于上手。

💡核心功能

• 时长追踪：精确记录每位玩家的在线游戏时间。
• 排行榜系统：可查看游戏时长 Top 10 榜单，激励玩家竞争。
• 里程碑奖励：为达到特定时长的玩家发放自定义奖励（物品或执行命令）。
• 重复性里程碑：支持设置可循环触发的里程碑奖励。
• 多语言支持：内置英语、荷兰语、德语、法语，并支持自定义语言文件。
• 数据存储：支持 MySQL、MongoDB 或 YAML 文件存储玩家数据。
• API 与扩展：提供 PlaceholderAPI 占位符和开发者 API，方便与其他插件集成。
• AFK 处理：可配置是否统计 AFK（挂机）时间，并支持与 Essentials 插件联动检测。

🎮命令列表

游戏时长命令

• /playtime - 查看自己的游戏时长。
• /playtime top - 查看游戏时长 Top 10 排行榜。
• /playtime reset <用户名> - 重置指定玩家的游戏时长。
• /playtime set <用户名> <秒数> - 设置指定玩家的游戏时长。
• /playtime <玩家名/UUID> - 查看其他玩家的游戏时长。
• /playtime reload - 重载插件配置与数据。
• /playtime add <玩家名> <秒数> - 为指定玩家增加游戏时长。
• /playtime importPlaytime - 从 Minecraft 原生数据导入所有玩家的游戏时长。
• 警告：此操作将覆盖数据库中现有的所有时长数据。

里程碑命令

• /milestone create <名称> <秒数> - 创建一个里程碑。
• /milestone list - 列出所有已创建的里程碑。
• /milestone remove <里程碑> - 删除指定的里程碑。
• /milestone info <里程碑> - 查看里程碑信息及编辑选项。
• /milestone test <里程碑> - 在自己身上测试执行该里程碑的奖励。
• /milestone addItemToMilestone <里程碑> - 将主手持有的物品添加为该里程碑的奖励。
• /milestone addCommandToMilestone <里程碑> <命令> - 添加一个由控制台执行的命令作为奖励。长命令需用引号包裹（例如："give %playername% apple 64"）。
• /milestone togglefirework <里程碑> - 切换该里程碑触发时是否播放烟花。
• /milestone setfireworkamount <里程碑> <数量> - 设置该里程碑触发时烟花的发射数量。
• /milestone setfireworkdelay <里程碑> <秒数> - 设置烟花发射之间的延迟时间。
• /milestone addMessage <里程碑> <消息> - 为该里程碑添加一条触发消息。
• /milestone removeMessage <里程碑> <消息> - 移除该里程碑的一条触发消息。

重复性里程碑命令

重复性里程碑的命令与普通里程碑基本一致，只需将 /milestone 替换为 /repeatingmilestone 即可，例如：

• /repeatingmilestone create <名称> <秒数>
• /repeatingmilestone list
• 其余命令格式类比上述里程碑命令。

🔧权限节点

游戏时长权限

• /playtime - playtime.playtime
• /playtime top - playtime.playtime.top
• /playtime reset <用户名> - playtime.playtime.reset
• /playtime <玩家名/Uuid> - playtime.playtime.other
• /playtime migratefromminecraft - playtime.playtime.migratefromminecraft
• /playtime reload - playtime.playtime.reload
• /playtime importPlaytime - playtime.playtime.importPlaytime

里程碑权限

• /milestone create - playtime.milestone
• /milestone additem - playtime.milestone.additem
• /milestone addcommand - playtime.milestone.addcommand
• /milestone togglefirework - playtime.milestone.additem
• /milestone setfireworkamount - playtime.milestone.setfireworkamount
• /milestone setfireworkdelay - playtime.milestone.setfireworkdelay
• /milestone remove - playtime.milestone.remove
• /milestone info - playtime.milestone.info

重复性里程碑权限与上述里程碑权限相同。

❓配置与使用

里程碑设置

里程碑基于玩家的累计游戏时长触发奖励。时长单位需以秒输入。奖励可以是物品或控制台命令。在命令中，可以使用 %playername% 和 %playeruuid% 作为玩家名和 UUID 的占位符。

语言与本地化

插件支持多语言。可通过编辑 config.yml 文件中的 language: 选项来切换语言。

• 可选内置语言代码：en_GB (英语), nl_NL (荷兰语), de_DE (德语), fr_FR (法语)。
• 你也可以在 lang 文件夹中创建或修改语言文件来自定义消息。
• 对于服务器版本 >= 1.16 的用户，可以在语言文件中使用十六进制颜色代码。

数据库配置

玩家数据和里程碑信息可以存储在 MySQL、MongoDB 或 YAML 文件中。相关配置请在 database.yml 文件中进行设置。

AFK 时间处理

若不想统计玩家的 AFK 时间，可在 config.yml 中进行如下设置：

• 将 countAfkTime 设置为 false。
• 如需使用 Essentials 插件检测 AFK 状态，请将 useEssentialsApi 设置为 true。

✨PlaceholderAPI 占位符

本插件与 PlaceholderAPI 完全兼容，可提供以下占位符供其他插件或菜单使用：

• %tdrplaytime_time% - 显示完整的游戏时长（格式同 /playtime 命令）。
• %tdrplaytime_days_number% - 显示在线天数（数字）。
• %tdrplaytime_hour_number% - 显示在线小时数（数字）。
• %tdrplaytime_minutes_number% - 显示在线分钟数（数字）。
• %tdrplaytime_seconds_number% - 显示在线秒数（数字）。
• %tdrplaytime_total_hour_number% - 显示总小时数（包含天数转换）。
• %tdrplaytime_top_names_{1-10}% - 显示排行榜第 1-10 名的玩家名。请将 {1-10} 替换为具体数字（1到10）。
• %tdrplaytime_top_time_{1-10}% - 显示排行榜第 1-10 名玩家的总游戏时长。
• %tdrplaytime_top_time_{1-10}_seconds% - 显示排行榜玩家游戏时长的“秒”部分。
• %tdrplaytime_top_time_{1-10}_minutes% - 显示排行榜玩家游戏时长的“分钟”部分。
• %tdrplaytime_top_time_{1-10}_hours% - 显示排行榜玩家游戏时长的“小时”部分。
• %tdrplaytime_top_time_{1-10}_days% - 显示排行榜玩家游戏时长的“天”部分。

⭐开发者 API

插件为开发者提供了两个事件，可用于开发自定义功能：

• PlayTimeCheckEvent：每次检查玩家时长时触发。
• PlayTimeUpdatePlayerEvent：每个玩家的游戏时长更新时触发。通过此事件可以获取玩家更新前和更新后的游戏时长。

如需使用 API 进行开发，推荐使用 [此 Maven 仓库](this maven repo)。

💡注意事项与未来计划

• 使用 /playtime importPlaytime 命令前务必备份数据，该操作会覆盖现有数据库时长。
• 在里程碑命令中使用长命令时，务必用英文引号 " 将整个命令包裹起来。
• 配置语言时，请确保语言代码与 lang 文件夹中的文件名对应。

**开发计划 (Todo)**

• 多世界支持
• 更多占位符

如需帮助，请查阅 GitHub Wiki 页面。如果你喜欢这个插件，请别忘了留下评价！

**关联插件推荐**

• 如需烟花特效插件，请使用 Advanced Firework！