Fiw Clock

Fiw Clock

Tickwatch is a tiny, server-side Minecraft mod that records each player's playtime, kills, and deaths and stores them in a plain JSON file per world. It runs on both Fabric and NeoForge.

78 downloads
0 followers

Tickwatch

Track playtime, kills, and deaths โ€” server-side, lightweight, crash-safe.

Tickwatch quietly records how long each player has played and how many kills and deaths they rack up, then stores it all in a clean JSON file. No client mod required, no commands to learn, no impact on your TPS.


โœจ Why Tickwatch?

  • ๐Ÿชถ Featherweight โ€” tracking is one integer per online player per tick. That's it.
  • ๐Ÿ–ฅ๏ธ Server-side only โ€” your players join with a vanilla client. Install it on the server and forget it.
  • ๐Ÿ”€ Fabric and NeoForge โ€” same mod, both loaders.
  • ๐Ÿ’พ Crash-safe by design โ€” atomic writes with a rotating backup. A sudden power loss or hard crash cannot corrupt your stats.
  • โšก Never blocks the server โ€” all disk writes run on a dedicated background thread.

๐Ÿ“Š What it tracks

For every player, per world:

Stat Detail
โฑ๏ธ Playtime Counted in ticks, with a human-readable 2h 14m 30s field
โš”๏ธ Kills Mobs and players killed by that player
๐Ÿ’€ Deaths Times that player died

Stored at <world>/fiw-clock/stats.json:

{
  "players": {
    "069a79f4-44e9-4726-a5be-fca90e38aaf5": {
      "name": "Notch",
      "playTimeTicks": 144000,
      "playTimeFormatted": "2h 00m 00s",
      "kills": 12,
      "deaths": 3
    }
  }
}

Perfect for leaderboards, web dashboards, Discord bots, or anything that can read JSON.

๐Ÿ“ฆ Requirements

Minecraft 1.21.11 ยท Java 21+

  • Fabric: Fabric API + Fabric Language Kotlin
  • NeoForge: Kotlin for Forge

No Architectury or other wrapper mod required.

๐Ÿš€ Install

  1. Install Fabric or NeoForge on your server.
  2. Add the matching dependencies to mods/ โ€” Fabric: Fabric API + Fabric Language Kotlin; NeoForge: Kotlin for Forge.
  3. Drop in the Tickwatch jar for your loader.
  4. Start the server โ€” stats start tracking immediately.

๐Ÿ’ก Tickwatch is purely server-side. Players do not need it installed to join.

๐Ÿ“– Links

No gallery available for this project.