Tickwatch
追踪游戏时长、挂机时间、会话、玩家与生物击杀数、死亡次数以及击杀连胜 —— 服务端轻量级实现,崩溃安全,支持 LuckPerms。
Tickwatch 会在后台静默记录每位玩家的有效游戏时间(排除挂机时间)以及累计的击杀和死亡次数,并将所有数据存储在一个整洁的 JSON 文件中。无需客户端模组,不影响你的 TPS —— 当你需要查看时,使用 /tickwatch 命令即可。
✨ 为什么选择 Tickwatch?
- 🪶 极致轻量 — 对每个在线玩家,每刻钟仅追踪一个整数。仅此而已。
- 🖥️ 纯服务端 — 你的玩家可以使用原版客户端加入服务器。只需在服务端安装并忘记它。
- 🔀 支持 Fabric、NeoForge 和 Forge — 适用于 Minecraft 26.3、26.1.2、1.21.11、1.21.8、1.21.1 和 1.20.1。
- 💾 设计即防崩溃 — 采用原子写入配合轮换备份机制。突然断电或硬崩溃绝不会损坏你的统计数据。
- ⚡ 绝不阻塞服务器 — 所有磁盘写入均在专用的后台线程上运行。
- 💤 感知挂机状态 — 空闲玩家停止累积游戏时长;挂机池也无法通过挂机刷取时长。
- 🏆
/tickwatch命令 — 查询任何玩家(即使离线)的统计信息,以及任意统计项的排行榜。 - 📣 里程碑广播 — 可选的 "Notch 已游玩 100 小时!" 公告。
- 🔑 LuckPerms 集成 — 统计数据变为 LuckPerms 元数据(
tickwatch_kills、tickwatch_playtime、tickwatch_afk…),因此任何读取 LuckPerms 元数据的聊天、标签页或记分板模组都可以显示它们,且每个命令都有对应的权限节点。 - 🧩 公共 API — 其他模组可以读取统计信息、排行榜,并监听击杀、死亡和挂机变化事件。
当安装了 Admin Tools 1.4.0+ 时,Tickwatch 1.2.0+ 会共享其挂机状态,包括 /fiw afk。在 config/fiw-admin/afk.json 中配置 AFK;当单独运行时,Tickwatch 会自动检测 AFK。
📊 追踪内容
针对每位玩家,按世界维度:
| 统计项 | 详情 |
|---|---|
| ⏱️ 游戏时长 | 以刻为单位的有效时间,附带人类可读的 2h 14m 30s 字段 |
| 💤 挂机时间 | 在线但空闲的时间,以及实时挂机标志 |
| 🕒 会话 | 当前会话和历史上最长的会话 |
| ⚔️ 击杀 | 总击杀数,以及分别统计的玩家击杀和生物击杀 |
| 💀 死亡 | 该玩家的死亡次数,以及K/D 比率 |
| 🔥 击杀连胜 | 当前连胜数(死亡后重置)和历史最高连胜 |
| 📅 登录 | 登录次数、首次登录日期、最后上线日期 |
存储路径为 <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
}
}
}
非常适合用于排行榜、Web 仪表板、Discord 机器人或任何能读取 JSON 的工具。
💬 命令
| 命令 | 权限节点 | 默认权限 |
|---|---|---|
/tickwatch stats [player] |
tickwatch.command.stats (.stats.others) |
所有人 |
/tickwatch top <stat> [count] |
tickwatch.command.top |
所有人 |
/tickwatch reload |
tickwatch.command.reload |
管理员 |
📦 依赖要求
| Minecraft | 加载器 | Java |
|---|---|---|
| 26.3 | Fabric, NeoForge | 25+ |
| 26.1.2 | Fabric, NeoForge | 25+ |
| 1.21.11 | Fabric, NeoForge | 21+ |
| 1.21.8 | Fabric, NeoForge | 21+ |
| 1.21.1 | Fabric, NeoForge | 21+ |
| 1.20.1 | Fabric, Forge | 17+ |
- Fabric: Fabric API + Fabric Language Kotlin 1.13.4+
- NeoForge / Forge: Kotlin for Forge (26.3 版本需 6.4+,26.1.2 版本需 6.2+,1.21.11 版本需 6.0+,1.21.8 版本需 5.10 或更新的 5.x,1.21.1 版本需 5.10+,1.20.1 版本需 4.12+)
可选:LuckPerms — 启用元数据同步(/lp user <name> meta info 将显示统计信息)。
无需 Architectury 或其他包装模组。
🚀 安装
- 在你的服务器上安装 Fabric、NeoForge 或 Forge。
- 将相应的依赖项添加到
mods/目录 — Fabric: Fabric API + Fabric Language Kotlin;NeoForge / Forge: Kotlin for Forge。 - 放入对应加载器和 Minecraft 版本的 Tickwatch jar 文件。
- 启动服务器 — 统计功能立即开始工作。
💡 Tickwatch 完全是服务端的。玩家加入时无需安装此模组。
📖 链接
- 📜 源码与 Issue:
- 🆓 许可证:MIT
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 26.3, 26.1.2, 1.21.11, 1.21.8, 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.
- 🏆
/tickwatchcommand — 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.
With Admin Tools 1.4.0+ installed, Tickwatch 1.2.0+ shares its AFK state, including /fiw afk.
Configure AFK in config/fiw-admin/afk.json; Tickwatch detects AFK itself when running alone.
📊 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 |
|---|---|---|
| 26.3 | Fabric, NeoForge | 25+ |
| 26.1.2 | Fabric, NeoForge | 25+ |
| 1.21.11 | Fabric, NeoForge | 21+ |
| 1.21.8 | Fabric, NeoForge | 21+ |
| 1.21.1 | Fabric, NeoForge | 21+ |
| 1.20.1 | Fabric, Forge | 17+ |
- Fabric: Fabric API + Fabric Language Kotlin 1.13.4+
- NeoForge / Forge: Kotlin for Forge (6.4+ on 26.3, 6.2+ on 26.1.2, 6.0+ on 1.21.11, 5.10 or a newer 5.x on 1.21.8, 5.10+ on 1.21.1, 4.12+ on 1.20.1)
Optional: LuckPerms — enables meta sync (/lp user <name> meta info shows the stats).
No Architectury or other wrapper mod required.
🚀 Install
- Install Fabric, NeoForge or Forge on your server.
- Add the matching dependencies to
mods/— Fabric: Fabric API + Fabric Language Kotlin; NeoForge / Forge: Kotlin for Forge. - Drop in the Tickwatch jar for your loader and Minecraft version.
- 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
下载 Fiw Clock
下载 Fiw Clock
下载 Fiw Clock
下载 Fiw Clock
下载 Fiw Clock
下载 Fiw Clock
下载 Fiw Clock
下载 Fiw Clock
下载 Fiw Clock
下载 Fiw Clock
[1.2.0] - 共享 AFK 状态与完整版本支持
Added
- 新增对 Fabric 和 NeoForge 26.3 及 26.1.2(Java 25;NeoForge 在 26.3 上需要 Kotlin for Forge 6.4+,在 26.1.2 上需要 6.2+)的支持,同时新增 Fabric 和 NeoForge 1.21.8,并保留所有现有目标平台。
- 与 Admin Tools 1.4.0+ 实现自动 AFK 集成:手动 AFK、标签、自动踢出和时间统计共享同一状态。当两者同时运行时,Admin Tools 的
afk.json负责管理 AFK 设置。独立的 Tickwatch 仍保留其基于摄像头的检测器。
Fixed
- 在禁用本地 AFK 的情况下重新加载 Clock,会保留 Admin Tools 中处于活动状态的 AFK 状态。
Changed
- 构建版本使用 Java 25,但在较旧的目标平台上仍保留 Java 17/21 字节码。所有十二个 jar 文件共享同一个版本号。
[1.1.0] - 2026-09-24
新增
- 支持 Minecraft 1.20.1 和 1.21.1:1.20.1 提供 Fabric + Forge,1.21.1 提供 Fabric + NeoForge,此外还有 1.21.11 的 Fabric + NeoForge 版本。所有 jar 包均由同一份代码构建。
- 玩家击杀与生物击杀分开统计(保留总计
kills)。 - 击杀连胜:当前连胜记录(死亡时重置)和历史最高连胜记录。
- 加入追踪:加入次数、首次加入日期和最后上线日期。
- K/D 比率:在所有暴露统计数据的地方均可查看。
- AFK 感知游戏时长:如果玩家 5 分钟未转动视角,则被视为 AFK;该段时间计入
afk_time而非游戏时长(配置项为afk.enabled/afk.minutes)。水流和活塞不被视为有效活动,因此 AFK 池无法刷取游戏时长。 - 会话记录:当前会话长度和历史最长会话记录。
/tickwatch命令:/tickwatch stats [player](对离线玩家同样有效),/tickwatch top <stat> [count]以及/tickwatch reload。权限节点tickwatch.command.stats、.stats.others、.top和.reload兼容 LuckPerms;若未安装 LuckPerms,则拥有commands.permissionLevel权限者可使用 stats/top,而 OP 可执行 reload。- 里程碑广播(默认关闭):聊天公告,例如 "Notch 已游玩 100 小时!",涵盖游戏时长(小时)、击杀数、击杀连胜、死亡数或加入数,支持自定义数值及
&颜色代码消息。 - LuckPerms 集成:当安装 LuckPerms 时,所有统计数据将镜像至玩家的 LuckPerms 元数据中(
tickwatch_name、tickwatch_kills、tickwatch_playtime、tickwatch_afk……),因此任何读取 LuckPerms 元数据的聊天、Tab 列表或记分板模组均可显示这些数据。可通过/lp user <name> meta info进行检查。以临时数据形式存储——永不写入 LuckPerms 数据库。 - 供其他模组使用的公共 API:
com.fiw.api.TickwatchApi(包含查询、排行榜以及变更监听器,包括 AFK 开始/结束事件)。 - 配置文件位于
<world>/fiw-clock/config.json(包含 LuckPerms、AFK、命令、里程碑相关配置)。
更改
- Jar 包命名现按目标平台区分:
fiw-clock-<loader>-<minecraft>-<version>.jar。 - 在启用 AFK 检测(默认设置)的情况下,
playtime仅计算活跃时间。将afk.enabled设置为false可使所有在线时间均计入游戏时长。 - 将 1.21.11 的 Fabric API 更新为 0.141.6,NeoForge 更新为 21.11.45。
修复
- NeoForge jar 包无法加载:由于 NeoForge 不允许 mod id 中包含
-字符,现在 NeoForge/Forge 的 mod id 改为fiw_clock(Fabric 的 id 及<world>/fiw-clock/数据文件夹保持不变)。
备注
- 此版本作为 beta 发布:如有任何异常,请在问题追踪器上报告。
- 现有的
stats.json文件可无变化地加载。在此版本之前记录的击杀数仅计入总数,因为它们从未被拆分为玩家击杀/生物击杀。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
AE2:一款流行的自动化与存储模组
评论 0
登录后参与评分
还没有评论,来抢沙发吧