高级游戏时长与奖励

---

⏳ 概述

Advanced Playtime & Rewards 是 Hytale 服务器的终极参与度插件。它以毫秒精度追踪玩家活动，显示实时自动更新的排行榜，并自动奖励活跃玩家。

与基础追踪器不同，该插件将实时会话数据与历史数据库统计相结合，确保排行榜和奖励始终即时且准确。

v1.3.0 新功能： 全自动定时奖励系统！直接在游戏中设置每日、每周或全时里程碑，让插件处理其余工作。

✨ 主要特性

• 🎁 定时奖励： 当玩家达到特定游戏时间目标时，自动执行控制台命令（物品、身份、货币）。
• 🖥️ 交互式 GUI： 在现代化的深色主题菜单中浏览排行榜，支持 每日、每周、每月 和 全时 统计标签页。
• 🛡️ 安全可控： 完整的权限支持（playtime.check、playtime.admin 等），让服务器管理员拥有完全控制权。
• 🚀 实时追踪： 前十名列表和个人统计信息即时更新——甚至在你游玩时也能同步。
• 🎨 十六进制颜色支持： 在所有广播消息和配置中使用现代 RGB 颜色（例如 &#FF0000）。
• 💾 双数据库支持：
  • SQLite： 零设置本地数据库（默认）。
  • MySQL： 面向大型网络的高性能支持。

🎁 如何添加定时奖励

你可以在游戏中直接配置奖励，无需编辑配置文件！

1. 创建奖励： 使用管理员命令添加新奖励。 /playtime admin addReward <id> <period> <time> "<command>"

• id： 唯一名称（例如 daily_bonus）。
• period： 选择 daily（每日）、weekly（每周）、monthly（每月）或 all（全时）。
• time： 所需时间（例如 30m、1h、1d）。
• command： 要执行的控制台命令。使用 %player% 代表玩家名称。

示例： 今日游戏时间达到 1 小时时给予 10 金币： /playtime admin addReward daily_gold daily 1h "economy give %player% 10"

2. 管理奖励：

• 列出所有奖励： /playtime admin listRewards
• 删除奖励： /playtime admin removeReward <id>
• 玩家查看： 玩家可以输入 /playtime rewards 查看已领奖励或即将获得的奖励！

📜 命令与权限

命令	权限	描述
/playtime	playtime.check	查看自己的总游戏时间。
/playtime rewards	playtime.check	查看自己的奖励状态（已领取/锁定）。
/playtime menu	playtime.gui	打开交互式排行榜 GUI。
/playtime top	playtime.top	查看排行榜。
/playtime admin	playtime.admin	查看奖励的游戏中教程。
/playtime admin addReward	playtime.admin	添加新的定时奖励。
/playtime reload	playtime.reload	无需重启即可重新加载 config.json。

注意：你可以在配置中将 /playtime 更改为 /pt、/stat 或任何自定义别名！

⚙️ 配置

插件会在你的 mods/Playtime 文件夹中生成一个 config.json 文件。你可以编辑：

• 奖励： 如果你更喜欢文件操作而非命令，也可以在 JSON 列表中手动编辑奖励。
• 数据库： 在 SQLite 和 MySQL 之间切换。
• 别名： 更改主命令名称和别名。
• GUI 设置： 自定义窗口标题、按钮名称和页脚文本。
• 消息： 完全控制前缀、十六进制颜色和文本输出。

🗺️ 开发路线图与待办事项

我们正在积极开发 Advanced Playtime！以下是即将推出的功能：

• AFK 检测： 如果玩家连续 X 分钟未移动，则停止计费游戏时间。
• 里程碑广播： 当玩家达到重大目标时向服务器公告（例如：“玩家已达到 100 小时！”）。
• Web 界面： （计划中）利用 MySQL 数据库在网站上查看排行榜。

🔧 安装

1. 下载 .jar 文件。
2. 将其放入 Hytale 服务器的 mods 文件夹。
3. 启动服务器！

---

发现了 Bug 或有建议？请在我们的 GitHub 仓库 提交 Issue！