promotional bannermobile promotional banner
premium banner

Advanced Playtime & Rewards

Allows server owners to track player activity with precision, store data locally or via MySQL, and display live, auto-updating leaderboards.

Description

⏳ 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]!