Fiw Clock

模组

· 作者 Fi3w0

Tickwatch 是一个轻量级的服务端 Minecraft 模组,用于记录每位玩家的游戏时长、击杀数和死亡数,并将数据以纯 JSON 文件的形式按世界分别存储。它同时支持 Fabric 和 NeoForge。

0 本站下载 0 关注 更新于 1 天前

需要前置:Kotlin for Forge

最新 1.2.0 · 1.20.1 · Forge

一键开服(送7天)

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 或其他包装模组。

🚀 安装

  1. 在你的服务器上安装 Fabric、NeoForge 或 Forge。
  2. 将相应的依赖项添加到 mods/ 目录 — Fabric: Fabric API + Fabric Language Kotlin;NeoForge / Forge: Kotlin for Forge。
  3. 放入对应加载器和 Minecraft 版本的 Tickwatch jar 文件。
  4. 启动服务器 — 统计功能立即开始工作。

💡 Tickwatch 完全是服务端的。玩家加入时无需安装此模组。

📖 链接

  • 📜 源码与 Issue:
  • 🆓 许可证:MIT

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源