Fiw Clock

Tickwatch

Track playtime, AFK time, sessions, player & mob kills, deaths and kill streaks — server-side, lightweight, crash-safe, LuckPerms-ready.

Tickwatch quietly records how long each player has played (AFK time excluded) and how many kills
and deaths they rack up, then stores it all in a clean JSON file. No client mod required, no impact
on your TPS — and a /tickwatch command when you want to look.

✨ 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, NeoForge and Forge — Minecraft 1.21.11, 1.21.1 and 1.20.1.
• 💾 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.
• 💤 AFK-aware — idle players stop earning playtime; AFK pools can’t farm it either.
• 🏆 /tickwatch command — stats of any player (even offline) and leaderboards for any stat.
• 📣 Milestone broadcasts — optional “Notch has played for 100 hours!” announcements.
• 🔑 LuckPerms integration — stats become LuckPerms meta (tickwatch_kills, tickwatch_playtime, tickwatch_afk, …) so any chat, tab or scoreboard mod that reads LuckPerms meta can display them, and every command has a permission node.
• 🧩 Public API — other mods can read stats, leaderboards and listen for kills, deaths and AFK changes.

📊 What it tracks

For every player, per world:

| Stat | Detail |
|——|——–|
| ⏱️ Playtime | Active time in ticks, with a human-readable 2h 14m 30s field |
| 💤 AFK time | Time online but idle, plus a live AFK flag |
| 🕒 Sessions | Current session and longest session ever |
| ⚔️ Kills | Total, plus player kills and mob kills separately |
| 💀 Deaths | Times that player died, plus K/D ratio |
| 🔥 Kill streaks | Current streak (reset on death) and best-ever streak |
| 📅 Joins | Login count, first-join date, last-seen date |

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

{
  "players": {
    "069a79f4-44e9-4726-a5be-fca90e38aaf5": {
      "name": "Notch",
      "playTimeTicks": 144000,
      "playTimeFormatted": "2h 00m 00s",
      "afkTicks": 14400,
      "kills": 12,
      "playerKills": 2,
      "mobKills": 10,
      "deaths": 3,
      "killStreak": 4,
      "bestKillStreak": 9,
      "joins": 27,
      "firstJoin": 1767225600000,
      "lastSeen": 1769904000000,
      "longestSessionTicks": 72000
    }
  }
}

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

💬 Commands

| Command | Permission node | Default |
|———|—————–|———|
| /tickwatch stats [player] | tickwatch.command.stats (.stats.others) | everyone |
| /tickwatch top <stat> [count] | tickwatch.command.top | everyone |
| /tickwatch reload | tickwatch.command.reload | ops |

📦 Requirements

| Minecraft | Loaders | Java |
|———–|———|——|
| 1.21.11 | Fabric, NeoForge | 21+ |
| 1.21.1 | Fabric, NeoForge | 21+ |
| 1.20.1 | Fabric, Forge | 17+ |

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

Optional: LuckPerms — enables meta sync (/lp user <name> meta info shows the stats).

No Architectury or other wrapper mod required.

🚀 Install

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

💡 Tickwatch is purely server-side. Players do not need it installed to join.

📖 Links

• 📜 Source & issues:
• 🆓 License: MIT