PlayTimeRewards - 在线时长奖励

本插件已停止开发。它最初由 @adamwbb 提议创建，并曾是最受欢迎的插件之一。它允许服务器根据玩家的每日登录和累计游戏时长自动发放奖励。

💡使用说明

首次加载插件后，请打开配置文件进行设置。你可以配置是否启用权限、每日登录和累计游戏时长达到指定小时时执行的命令，以及在线时间奖励的发放间隔。

• 使用 /playtime 或 /myplay 命令可以查看自己的总游戏时长。
• 注意：“累计游戏时长”指的是总游戏时间，而非单次会话的时长。

🎮权限节点

（必须在配置文件中启用权限功能后才生效！）

• playtimerewards.dailyJoinReward - 允许玩家接收每日登录奖励（默认授予，除非使用 PEX，因为 PEX 会忽略默认权限）。
• playtimerewards.hourOfPlayReward - 允许玩家接收累计游戏时长奖励（默认授予，除非使用 PEX）。
• playtimerewards.checkPlaytime - 允许玩家使用 /playtime 或 /myplay 查看自己的总游戏时长（默认授予，除非使用 PEX）。

🔧安装步骤

• 下载插件。
• 将 playtimerewards VX.X.X.jar 放入服务器的 plugins 文件夹。
• 重启/重载服务器，或使用插件加载器来启用 playtimerewards。
• 根据你的需求编辑配置文件。
• 重启/重载服务器，或使用插件加载器重新加载 playtimerewards。

✨配置指南

以下为配置文件的关键项说明

• configVersion: 1 - 请勿修改此项。
• hourOfPlayDelayMinutes: 60 - 发放累计游戏时长奖励的间隔时间（单位：分钟）。
• usePermissions: false - 是否启用权限系统来控制奖励发放。
• randomDailyJoinCommandsToRun: 1 - 玩家每日首次登录时，从随机命令列表中执行多少个命令。
• randomHourOfPlayCommandsToRun: 1 - 玩家达到累计游戏时长时，从随机命令列表中执行多少个命令。

命令列表配置：

• dailyJoinCommand: - 玩家每日首次登录时必定执行的命令列表。
• randomDailyJoinCommand: - 玩家每日首次登录时，从中随机抽取执行的命令列表。
• hourOfPlayCommand: - 玩家达到累计游戏时长时必定执行的命令列表。
• randomHourOfPlayCommand: - 玩家达到累计游戏时长时，从中随机抽取执行的命令列表。

命令格式提示：

• 使用 %player% 作为玩家名的占位符。
• 使用 & 符号作为颜色代码前缀。
• 可以随意添加或删除列表中的命令。

❓如何使用 API (ptr 2.2.0+)

若要在其他插件中调用本插件的 API，请按以下步骤操作：

• 在你的插件 plugin.yml 中添加依赖声明：

    depend: [PlayTimeRewards]

• 将 playtimerewards 的 JAR 文件作为依赖项添加到你的开发项目中（方式与添加 Bukkit API 类似）。
• 在你的代码中，通过以下方式获取插件实例：

    PlayTimeRewardsRecoded PTRR = PlayTimeRewardsRecoded.Instance;

（变量名 `PTRR` 可自定义，但需保持后续使用一致。）

• 获取玩家数据：

- `PTRR.PTRgetPlaytime(PlayerUUID)` - 返回一个 `long` 类型值，表示总游戏时长（格式为年/月/日）。

- `PTRR.PTRgetLastLogin(PlayerUUID)` - 返回一个 `String`，表示玩家最后登录时间。

> 提示：未来发布的排行榜功能也将通过 API 提供数据获取接口。

⭐其他信息

• 更新日志：请访问 http://www.spigotmc.org/resources/playtimerewards.2463/updates 查看。
• 视频教程：由 NumeroUno 制作（内容可能稍有过时）。
• 已知问题：存在少量可能导致崩溃的 Bug，建议在讨论区报告。
• 兼容性：插件本身不包含版本依赖代码，理论上支持所有版本，但仍可能与某些版本存在兼容性问题。
• 需要帮助？ 请在插件讨论区提问。