[MOVED] PlaytimeRewards - PlaytimeRewards

欢迎来到 PlaytimeRewards！本插件是原 PlaytimeRewards 插件的全新重制版，经过完全重写，运行更稳定，性能消耗更低。它能追踪每位玩家的在线时长，并在你设定的时间点给予他们奖励。

💡核心功能

• 追踪每位玩家的总游戏时长、单次游戏时长与 AFK 时长。
• 可高度自定义奖励规则，例如：累计游玩 1 小时、单次连续游玩 30 分钟等。
• 奖励内容支持执行控制台命令或玩家命令（后续正式版将支持粒子、音效与物品奖励）。
• 可选择禁用奖励系统，仅保留时长统计功能以降低性能消耗。

🎮命令列表

查看时长

• /pt 或 /playtime
• 权限: timerewards.seetime
• 功能: 查看自己的游戏时长。
• /pt <玩家> 或 /playtime <玩家>
• 权限: timerewards.seetime.others
• 功能: 查看其他玩家的游戏时长。
• /playtimetop 或 /pttop
• 权限: timerewards.seetop
• 功能: 查看游戏时长最高的玩家排行榜。
• 注意: Beta 版本中暂不可用。

管理与调试

• /pr reload 或 /PlaytimeRewards reload
• 权限: timerewards.reload
• 功能: 重载 config.yml 与 rewards.yml 配置文件。
• /pr giveReward <奖励名称> [玩家]
• 权限: timerewards.giveRewards
• 功能: 向指定玩家发放奖励（无视权限与所需时长）。
• /pr editItem <奖励名称>
• 权限: timerewards.editItem
• 功能: 修改指定奖励的奖励物品。
• 注意: Beta 版本中暂不可用。
• /pr listRewards
• 权限: timerewards.listRewards
• 功能: 列出所有已创建的奖励。
• /pr seeRewards [玩家]
• 权限: timerewards.seeRewards 或 timerewards.seeRewardsOthers
• 功能: 查看指定玩家已获得的奖励。
• 注意: Beta 版本中暂不可用。
• /pr setTime <玩家> <秒数> <时间类型>
• 权限: timerewards.setTime
• 功能: 修改玩家的游戏、单次或 AFK 时长。
• 注意: Beta 版本中暂不可用。

权限节点

• timerewards.*：授予本插件的所有权限。

🔧配置文件详解

config.yml

主要配置项包括

• ColorChar: 定义颜色代码字符（默认为 &）。
• MySQL: 启用或禁用 MySQL 存储。
• DisableRewards: 设置为 true 可完全禁用奖励系统，仅保留时长统计。
• DataSaveInterval: 自动保存数据的间隔（秒），设为 0 禁用（不推荐）。
• AutoUpdate: 是否自动更新插件。
• TopAmount: /pttop 命令显示的玩家人数。
• LoginDelay: 玩家登录后，开始计算奖励的延迟时间（秒），适用于搭配 AuthMe 等登录插件。
• SendRewardEarningMessage: 玩家可开始获得奖励时是否发送通知。
• NotifyPlaytimeDifference: 当玩家本次与上次游戏时长差异过大时，在控制台输出警告。

AFK 相关设置

• AfkTimer: 无操作多少秒后视为 AFK（秒），设为 0 禁用检测。
• AfkNotification: 是否发送 AFK 状态切换通知。
• CancelOnInteract / CancelOnChat / CancelOnMove / CancelOnLook: 哪些操作可以重置 AFK 计时。

MySQL 连接设置（仅在启用时需配置）

• Host、Port、User、Password、Database、useSSL。

lang.yml

在此文件中自定义插件发送的所有消息。可使用 VAR[x] 作为变量占位符，插件会在发送时自动替换。

消息类型包括

• 玩家通知（如 AFK 状态、获得奖励资格）。
• 控制台消息（如自动保存、更新提示）。
• 错误信息。
• 命令反馈信息。
• 库存界面（GUI）文本。

rewards.yml

这是定义所有奖励的核心文件。奖励分为两种类型

高级奖励 (AdvancedRewards)

• 可配置多个条件 (Condition)，使用逻辑运算符 (&, |, ()) 组合。
• 每个条件可独立设置：计时类型 (CountType)、所需权限 (PermissionNeeded)、最短/最长时长 (TimeMinimum/TimeMaximum)、允许/禁止的世界 (AllowedWorlds/DeniedWorlds)。
• 可配置触发动作 (TriggerAction)，包括：控制台命令 (RewardConsole)、玩家命令 (RewardCommand)、奖励物品 (RewardItem)、音效 (SoundName 等) 与粒子效果 (ParticleName 等)。
• 可设置是否允许重复获得 (MultipleObtainable)。

简单奖励 (SimpleRewards)

• 为单一条件奖励的简化配置格式，包含基本的时间、类型、消息和命令设置。

> 提示：计时类型 (CountType) 可选值包括：REALTIME（实时）、PLAYTIME（总游戏时长）、SESSIONTIME（单次游戏时长）、AFKTOTALTIME（总AFK时长）、AFKSESSIONTIME（本次AFK时长）。

❓已知限制（Beta 版本）

当前 Beta 版本中部分功能尚未完成或存在限制：

• 暂不可用的命令：
• /ptr editReward
• /ptr setTime
• /playtimetop
• 奖励系统限制：
• 粒子效果 (Particles) 和音效 (Sounds) 暂未被识别。
• 物品奖励 (Items) 暂未被识别。
• （目前可通过命令模拟实现部分效果）
• 配置文件：部分消息字段暂未使用，将在未来命令实现后启用。

⭐未来计划

开发者正在考虑的未来功能包括

• 内置游戏内奖励编辑器，无需手动编辑 YML 文件。
• 可自定义的命令别名，可通过 lang.yml 配置。

> 如果你有更多想法，欢迎在讨论区或通过私信向开发者反馈！

✨常见问题解答 (F.A.Q.)

问：我正在使用旧版 PlaytimeRewards（v2.9 之前），如何更新？

• 直接替换旧的 PlaytimeRewards.jar 文件即可。但请注意：新版插件无法读取旧版插件的数据，所有玩家的进度将会重置。建议在更新前备份旧数据。

问：我能从当前版本降级到旧版 PlaytimeRewards（v2.9 之前）吗？

• 不能。新版插件使用了不同的数据存储格式，无法兼容。你只能使用在旧版插件时创建的备份数据。

问：这个插件支持 Minecraft 1.13 以下的版本吗？

• 经测试，插件可在 Minecraft 1.8 至 1.13 版本上运行。1.7 及以下版本可能无法正常工作。

问：插件如何保存数据？

• 支持两种方式：MySQL 数据库或插件文件夹内的扁平文件存储。具体配置请查看 config.yml。
• 本插件使用 HikariCP 连接池，并通过 bStats 收集匿名使用数据。

💡重要声明

• 感谢 ViscousHurricane 制作的精美横幅与标题！
• 本插件禁止任何形式的再分发。
• 请勿移除插件内的任何版权信息。
• 使用本插件即表示你同意其数据收集条款。