RustTimeTracker 1.0.2

This tool is designed to make your time in Rust more efficient and enjoyable. The plugin tracks your in-game time, offering you customized rewards and advantages. Whether you're a beginner or an experienced adventurer, this plugin will elevate your gaming experience to a whole new level.

How It Works

• Time Tracking: Each player’s activity is monitored in real time. The system differentiates between active play and AFK, ensuring that rewards are earned fairly.
• Kit Claiming: Players can claim kits via a simple console command once they meet the required playtime hours set in the config. This system is designed to motivate players to stay longer and engage more with the server.
• Dynamic Config Updates: The plugin reads from the config.json file on startup, meaning changes to kits and settings can be made on the fly without needing plugin restarts.
• UI Notifications: Utilizes Rust's CUI system to provide players with a seamless interface for tracking their statistics and available rewards.
• Ranking & BetterChat Integration (Optional) All players are ranked based on their total playtime. The plugin: Keeps a live ranking of all players. Broadcasts messages when someone enters the top 5, climbs the ladder, or reaches #1. Can automatically place Top 1–5 players into BetterChat groups (e.g. top1, top2, …) to give them special prefixes/tags in chat. These groups are configurable and can be individually enabled/disabled.

Key Features

• Player Time Tracking: Automatically tracks total, active, and AFK time spent in-game for each player.
• Reward System: Players can earn kits based on the amount of time they've spent playing. These kits are customizable and can be configured to suit different play styles or server themes.
• Dynamic Configuration: All kits and rewards can be easily added, modified, or removed via the config.json file. This allows server admins to tailor the experience without needing to touch the code.
• Ranking System: Keeps track of players' activity and ranks them, promoting a competitive environment. Alerts are broadcasted when players enter the top ranks.
• Multi-language Support: Comes with multilingual support for messages and commands, enhancing accessibility for global players.

Admin Commands

• /taddtime <steamId> <seconds> -  Manually adjust the total server time for a player.
• /tremovetime <steamId> <seconds>  - Decrease the recorded time for a player to correct discrepancies.
• /tplayerwipe <steamId>  - Completely reset a player's data.
• /twipe  - Wipe all player data on the server – useful for server resets or new seasons.
• /resetplayerkits <steamId>  - Reset the claim status of all kits for a specific player, allowing them to claim them again.

Player Commands

/topplay - The /topplay command in the RustTimeTracker plugin activates a comprehensive in-game UI menu that displays detailed statistics about your gameplay on the server. This command brings up a user-friendly interface directly within the game, offering you an easy way to view your total playtime, active time, AFK time, and your current rank within the server's active player base.

/mytime Sends a simple chat summary: Your rank Total time Active time AFK time (The claimkit console command is used internally by the UI but can also be called manually from the console if needed.)

Config  

In the configuration settings, it’s important that the kit names exactly match the kit names defined in your Kits plugin (e.g. Kits.cs). The structure below reflects the current config layout, including the new BetterChat rank integration. Set Enabled to true for any rank you want to sync with BetterChat. Make sure the "Group Name" matches an existing BetterChat group, or let the plugin auto-create it.

{
  "UI Header Title": "Playing time",
  "UI Header Description": "Earn rewards based on the time spent in the game and keep your place in the ranking!",
  "Available Kits": [
    {
      "Name": "Basic Kit",
      "Description": "Starter tools for new players.",
      "RequiredPlaytimeHours": 1,
      "IsClaimed": false
    },
    {
      "Name": "Advanced Kit",
      "Description": "High-quality tools for advanced players.",
      "RequiredPlaytimeHours": 2,
      "IsClaimed": false
    }
  ],
  "Rank Chat Groups": [
    {
      "Rank": 1,
      "Enabled": false,
      "Group Name": "top1"
    },
    {
      "Rank": 2,
      "Enabled": false,
      "Group Name": "top2"
    },
    {
      "Rank": 3,
      "Enabled": false,
      "Group Name": "top3"
    },
    {
      "Rank": 4,
      "Enabled": false,
      "Group Name": "top4"
    },
    {
      "Rank": 5,
      "Enabled": false,
      "Group Name": "top5"
    }
  ]
}