Advanced Playtime & Rewards

---

⏳ 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

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

---

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