zalk's stats

模组

· 作者 zallkyre

一个极简的统计工具,可记录硬件信息、TPS、FPS、堆内存使用情况以及玩家事件,使 bug 追踪更加便捷。

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

需要前置:Fabric API

最新 1.4.2 · 26.3 · Fabric

一键开服(送7天)

zalk 的状态统计

一个 Fabric 模组,用于将硬件、性能和玩家事件记录到游戏日志中,从而更轻松地排查 Bug 和性能问题。

记录内容

启动时(仅一次):

  • 环境类型(客户端或服务器)及模组版本
  • Fabric Loader 版本
  • Java 版本与虚拟机名称
  • 操作系统名称、版本及架构
  • 可用处理器数量
  • JVM 已用内存与最大内存
  • CPU 型号、物理/逻辑核心数以及 1 秒 CPU 负载采样
  • 总内存与可用内存

硬件探测在后台守护线程上运行,因此 1 秒 CPU 负载采样不再阻塞游戏启动。

仅限客户端:

  • 当 FPS 持续 10 秒处于或低于你的阈值时,发出低 FPS 警告。仅记录一次,不会刷屏。
  • 当 FPS 回升至恢复阈值以上时,发送一次恢复通知。
  • 按你设定的间隔输出 FPS 摘要(平均值与最低值)。

仅限服务器:

  • 按你设定的间隔输出 TPS(1 分钟 / 5 分钟 / 15 分钟)
  • 专用服务器上,JVM 堆内存使用情况(附带每次报告的增量)
  • 玩家加入与断开连接事件
  • 服务器启动与停止,以及运行时长

配置

设置保存在 .minecraft/config/zalks-stats.json 中,也可在游戏内通过 Mod Menu 界面进行编辑。建议安装 Mod Menu,但非必需。

设置项 选项 默认值
低 FPS 警告阈值 10–90 FPS 20
FPS 恢复阈值 10–120 FPS 30
FPS 摘要间隔 60, 120, 300, 600, 900 秒 300
TPS 间隔 1, 2, 5, 10, 20, 30 秒 5
堆内存间隔 60, 120, 300, 600, 900 秒 300
日志开关 hardware, environment, FPS, TPS, heap, player join/leave, server lifecycle 全部开启

加载和保存时会对数值进行钳制,因此手动编辑或损坏的配置文件绝不会让模组陷入不合逻辑的状态。恢复阈值始终保持在警告阈值之上,以防止警告立即重新触发。

要求

  • Minecraft 26.3
  • Fabric Loader 0.19.5 或更高版本
  • Java 25 或更高版本
  • Fabric API
  • Mod Menu(可选,用于提供设置界面)

同时适用于客户端和专用服务器。客户端专属代码不会在服务器上加载。

安装

  1. 为 Minecraft 26.3 安装 Fabric Loader 和 Fabric API。
  2. 下载 zalks-stats-1.4.2.jar。
  3. 将其放入你的 mods 文件夹。
  4. 启动游戏。

构建

git clone https://github.com/zallkyre/zalks-stats.git
cd zalks-stats
./gradlew build

构建生成的 jar 文件位于 build/libs/ 中。需要 Java 25 或更高版本。

许可证

发布于公共领域。请参阅 LICENSE 文件。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源