⏳ Overview

Advanced Playtime & Rewards is the ultimate engagement plugin for Hytale servers. It tracks player activity with millisecond precision, displays live auto-updating leaderboards, and automatically rewards players for their dedication.

Unlike basic trackers, this plugin combines real-time session data with historical database stats to ensure leaderboards and rewards are always instant and accurate.

New in v1.3.0: A fully automated Timed Reward System! Set up daily, weekly, or all-time milestones directly in-game and let the plugin handle the rest.

✨ Key Features

🎁 Timed Rewards: Automatically execute console commands (items, ranks, currency) when players reach specific playtime goals.
🖥️ Interactive GUI: Browse leaderboards in a modern, dark-themed menu with tabs for Daily, Weekly, Monthly, and All-time stats.
🛡️ Secure & Manageable: Full permission support (playtime.check, playtime.admin, etc.) gives server owners total control.
🚀 Live Tracking: Top 10 lists and personal stats update instantly—even while you are playing.
🎨 Hex Color Support: Use modern RGB colors (e.g., &#FF0000) in all your broadcast messages and configs.
💾 Dual Database Support:
- SQLite: Zero-setup local database (default).
- MySQL: High-performance support for large networks.

🎁 How to Add Timed Rewards

You can configure rewards directly in-game without touching config files!

1. Create a Reward: Use the admin command to add a new reward. /playtime admin addReward <id> <period> <time> "<command>"

id: A unique name (e.g., daily_bonus).
period: Choose daily, weekly, monthly, or all (all-time).
time: The required time (e.g., 30m, 1h, 1d).
command: The console command to run. Use %player% for the username.

Example: Give 10 gold after 1 hour of playtime today: /playtime admin addReward daily_gold daily 1h "economy give %player% 10"

2. Manage Rewards:

List all rewards: /playtime admin listRewards
Delete a reward: /playtime admin removeReward <id>
Player view: Players can type /playtime rewards to see what they have claimed or what is coming up next!

📜 Commands & Permissions

Command	Permission	Description
`/playtime`	`playtime.check`	View your own total playtime.
`/playtime rewards`	`playtime.check`	View your reward status (Claimed/Locked).
`/playtime menu`	`playtime.gui`	Open the interactive Leaderboard GUI.
`/playtime top`	`playtime.top`	View the Leaderboard.
`/playtime admin`	`playtime.admin`	View the in-game tutorial for rewards.
`/playtime admin addReward`	`playtime.admin`	Add a new timed reward.
`/playtime reload`	`playtime.reload`	Reload the `config.json` without restarting.

Note: You can change /playtime to /pt, /stat, or any custom alias in the config!

⚙️ Configuration

The plugin generates a config.json in your mods/Playtime folder. You can edit:

Rewards: You can also edit rewards manually in the JSON list if you prefer files over commands.
Database: Switch between SQLite and MySQL.
Aliases: Change the main command name and aliases.
GUI Settings: Customize the window title, button names, and footer text.
Messages: Full control over prefixes, hex colors, and text output.

🗺️ Roadmap & To-Do

We are actively developing Advanced Playtime! Here is what's coming next:

AFK Detection: Stop counting playtime if a player hasn't moved for X minutes.
Milestone Broadcasts: Announce to the server when a player hits a major goal (e.g., "Player has reached 100 hours!").
Web Interface: (Planned) View leaderboards on a website using the MySQL database.

🔧 Installation

Download the .jar file.
Drop it into your Hytale Server's mods folder.
Start the server!

Found a bug or have a suggestion? Open an issue on our [GitHub Repository]!