HyStaffPT

非活跃开发中

🐝 HyStaffPT | 高级工作人员活动追踪器

HyStaffPT 是一款轻量级、高性能的 Hytale 服务器插件，专为需要透明、自动化团队活动监督的管理员设计。从追踪挂机与活跃时间到直接向您的 Discord 发送精美的自动报告，HyStaffPT 处理后勤事务，让您专注于管理社区。

---

✨ 主要特性

• ⏱️ 精确活动追踪： 智能检测区分活跃游戏时间和挂机时间。仅追踪拥有特定权限的用户，保持数据库整洁。
• 🔗 Discord 网页钩子集成： 无需机器人令牌或复杂的 API 设置。输入网页钩子 URL 即可接收高质量、可自定义的嵌入消息。
• 📅 自动汇总： 安排每日、每周和每月排行榜。让您的团队保持动力，并让管理随时了解情况，无需手动操作。
• 🏆 游戏内排行榜： 使用简单命令直接在游戏内查看“历史”顶级工作人员。
• 📊 数据可移植性： 自动将每周和每月摘要导出为 JSON 文件，存放在 /reports/ 文件夹中——非常适合外部电子表格或网页仪表板。
• 🎨 100% 可自定义： 从 Discord 嵌入消息的十六进制颜色代码到每一条聊天消息，您可以完全控制插件的外观。

---

🛠️ 安装指南

1. 下载最新版本的 HyStaffPT.jar。
2. 将文件放入您服务器的 plugins 文件夹中。
3. 依赖项： 确保已安装 [HyLib] 和 sqlite-jdbc。
4. 重启服务器以生成默认配置文件。
5. 在 webhook.yml 中配置您的网页钩子 URL。
6. 关键步骤： 授予您的工作人员角色 hystaffpt.playtime 权限以开始追踪。

---

📜 命令与权限

工作人员命令

命令	描述	权限
/staffpt query <玩家> <天数>	查看特定玩家的详细统计信息。	User
/staffpt top	显示历史游戏时间排行榜。	User

管理员命令

命令	描述	权限
/staffpt weekly	手动触发每周 Discord 报告。	hystaffpt.admin
/staffpt monthly	手动触发每月 Discord 报告。	hystaffpt.admin
/staffpt reload	热重载所有配置、消息和网页钩子文件。	hystaffpt.admin

注意： 将 hystaffpt.playtime 分配给任何您想要追踪的用户组。如果没有此权限，插件将完全忽略其游戏时间。

---

⚙️ 配置文件

• config.yml： 切换功能、调整挂机阈值和设置报告计划。
• webhook.yml： 自定义 Discord 标题、颜色、缩略图和页脚文本。
• messages.yml： 所有游戏内文本的完整本地化支持。

---

🐝 由 BUSYBEE 开发

HyStaffPT 由 BusyBee Development 维护。我们专注于为 Hytale 社区创建沉浸式、性能优化的工具。

🌐 DISCORD