🐝 HyStaffPT | Advanced Staff Activity Tracker

HyStaffPT is a lightweight, high-performance Hytale server plugin designed for administrators who need transparent, automated oversight of their staff team's activity. From tracking AFK vs. Active hours to delivering beautiful automated reports directly to your Discord, HyStaffPT handles the logistics so you can focus on managing your community.

---

✨ Key Features

• ⏱️ Precise Activity Tracking: Intelligent detection differentiates between active gameplay and AFK time. Only tracks users with specific permissions to keep your database clean.
• 🔗 Discord Webhook Integration: No bot tokens or complex API setups. Plug in a Webhook URL and receive high-quality, customizable embeds.
• 📅 Automated Summaries: Schedule Daily, Weekly, and Monthly leaderboards. Keep your staff motivated and your management informed without lifting a finger.
• 🏆 In-Game Leaderboards: View the "All-Time" top staff members directly in-game with simple commands.
• 📊 Data Portability: Automatically exports weekly and monthly summaries to JSON files in the /reports/ folder—perfect for external spreadsheets or web dashboards.
• 🎨 100% Customizable: From the hex codes in Discord embeds to every single chat message, you have full control over the plugin's "voice."

---

🛠️ Installation Guide

1. Download the latest HyStaffPT.jar.
2. Drop the file into your server's plugins folder.
3. Dependencies: Ensure you have [HyLib] and sqlite-jdbc installed.
4. Restart your server to generate the default configuration files.
5. Configure your Webhook URLs in webhook.yml.
6. Crucial: Grant the hystaffpt.playtime permission to your staff roles to begin tracking.

---

📜 Commands & Permissions

Staff Commands

Command	Description	Permission
/staffpt query <player> <days>	View detailed stats for a specific player.	User
/staffpt top	Display the all-time playtime leaderboard.	User

Admin Commands

Command	Description	Permission
/staffpt weekly	Manually trigger the weekly Discord report.	hystaffpt.admin
/staffpt monthly	Manually trigger the monthly Discord report.	hystaffpt.admin
/staffpt reload	Hot-reload all config, message, and webhook files.	hystaffpt.admin

Note: Assign hystaffpt.playtime to any group you wish to track. If they don't have this permission, the plugin will ignore their playtime entirely.

---

⚙️ Configuration Files

• config.yml: Toggle features, adjust AFK thresholds, and set report schedules.
• webhook.yml: Customize Discord titles, colors, thumbnails, and footer text.
• messages.yml: Full localization support for all in-game text.

---

🐝 DEVELOPED BY BUSYBEE

HyStaffPT is maintained by BusyBee Development. We focus on creating immersive, performance-optimized tools for the Hytale community.