ChronosRewards

ChronosRewards is a server-side Fabric mod that adds daily login streak rewards and playtime milestone rewards for multiplayer servers. Everything runs on the server, so vanilla clients can join and use the reward menu without installing any client-side mods.

There are no dependencies besides Fabric Loader. The mod does not require Fabric API.

What the mod does

When a player joins the server, the mod records the login time and counts playtime while the player is online. Players open a chest-style reward menu with a chat command. Each reward in the menu shows whether it can be claimed, is already claimed, or is still locked. Claiming a reward runs the server commands configured for it, for example giving items.

Daily streak rewards unlock based on consecutive days played. A streak increases when the player returns inside the configured time window and resets when the player stays away longer than the maximum window.

Playtime rewards unlock based on total time played on the server, measured in game ticks (20 ticks equal one second).

Reward progress and claims are saved automatically and persist across server restarts.

Requirements

• A Fabric server with Fabric Loader installed.
• Java 21 or newer for the 1.21.x version of the mod.
• Java 25 or newer for the 26.1.x, 26.2.x, and 26.3 versions of the mod.
• No client-side installation is needed. Players with a vanilla client can use the mod.

Download the mod file that matches your server's Minecraft version. Each download page lists the supported Minecraft versions.

Installation

1. Download the ChronosRewards file built for your server's Minecraft version.
2. Place the .jar file into the mods folder of your server.
3. Start the server once. The configuration file is generated automatically at config/chronos-rewards.json.
4. Stop the server, edit the configuration file to define your rewards, then start the server again.
5. Players open the menu in-game with the configured command (default /rewards).

To update the configuration while the server is running, edit the file and restart the server or reload configuration so the new values take effect.

Commands

There are no operator-only commands. Reward commands defined in the configuration run from the server console when a player claims a reward.

Configuration

The configuration file is config/chronos-rewards.json. It is created with default values on the first server start. Both standard JSON and HOCON-like syntax with comments are accepted.

Main settings

Reward entries

Each object in the rewards array defines one reward slot in the menu.

Lore placeholders

These placeholders can be used in lore lines:

Command placeholders

These placeholders can be used in commands entries:

Example configuration

{
  "command": "rewards",
  "autosave_interval_ticks": 1200,
  "menu": {
    "title": "Chronos Rewards",
    "rows": 3
  },
  "streak": {
    "minimum_window_millis": 72000000,
    "maximum_window_millis": 172800000
  },
  "rewards": [
    {
      "id": "daily_1",
      "type": "daily",
      "slot": 10,
      "required_streak": 1,
      "title": "Daily Streak: Day 1",
      "item": "minecraft:emerald",
      "lore": ["Current streak: {streak} day(s)", "{status}"],
      "commands": ["give {player} emerald 1"]
    },
    {
      "id": "daily_7",
      "type": "daily",
      "slot": 12,
      "required_streak": 7,
      "title": "Daily Streak: Day 7",
      "item": "minecraft:diamond",
      "lore": ["Current streak: {streak} day(s)", "{status}"],
      "commands": ["give {player} diamond 1"]
    },
    {
      "id": "playtime_1h",
      "type": "playtime",
      "slot": 14,
      "required_ticks": 72000,
      "title": "Playtime: 1 Hour",
      "item": "minecraft:clock",
      "lore": ["Played: {playtime}", "{status}"],
      "commands": ["give {player} gold_ingot 2"]
    }
  ]
}

Menu appearance

Empty menu slots are filled with a neutral glass pane so the menu looks complete. Each reward shows its title in bold with a color matching its state: green for claimable, gold for claimed, red for locked. Below the configured description lines, every reward shows a separator, a colored status line, and a progress line such as Progress: 1h 5m / 3h 0m or Streak: 2 / 7 days. Claimable rewards glow with an enchantment glint and show a "Click to claim" hint.

Technical notes

• The 1.21.x build uses Yarn mappings and stores player data as JSON files written asynchronously on virtual threads.
• The 26.1.x, 26.2.x, and 26.3 builds use official Mojang mappings and store player data with the vanilla saved-data system.
• Adapting to Minecraft 26.2 and 26.3: colored items such as stained glass panes were grouped into color collections, so the menu background now resolves the gray pane variant through the new collection API. No other mod behavior changed.
• Fabric Loader remaps the mod at runtime, so each build supports the Minecraft version family listed on its download page.

License

Copyright (c) 2026 TOPG-V. All Rights Reserved.