
扎尔克的属性
用于记录硬件、TPS、FPS、堆和玩家事件的极简统计工具,从而让缺陷更容易追踪。
zalk 的统计
一个 Fabric 模组,将硬件、性能和玩家事件记录到游戏日志中,使错误和性能问题更易于追踪。
记录内容
启动时,一次性记录:
- 环境类型(客户端或服务端)及模组版本
- Fabric Loader 版本
- Java 版本和虚拟机名称
- 操作系统名称、版本和架构
- 可用处理器数量
- JVM 已用内存与最大内存对比
- CPU 型号、物理/逻辑核心数,以及 1 秒 CPU 负载采样
- 总内存和可用内存
硬件探测在后台守护线程上运行,因此 1 秒 CPU 负载采样不再阻塞游戏启动。
仅客户端:
- 当 FPS 持续 10 秒处于或低于你的阈值时,发出低 FPS 警告。仅记录一次,不会反复刷屏。
- 当 FPS 回升至你的恢复阈值时,发出一次恢复通知。
- 按你选择的间隔输出 FPS 摘要(平均值和最小值)。
仅服务端:
- 按你选择的间隔输出 TPS 1m / 5m / 15m
- 在专用服务器上输出 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 |
| 日志开关 | 硬件、环境、FPS、TPS、堆内存、玩家加入/离开、服务器生命周期 | 全部开启 |
数值在加载和保存时会被限制在有效范围内,因此手动编辑或损坏的配置文件绝不会让模组处于不合理状态。恢复阈值始终保持在警告阈值之上,因此警告不会立即重新触发。
要求
- Minecraft 26.3
- Fabric Loader 0.19.5 或更新版本
- Java 25 或更新版本
- Fabric API
- Mod Menu(可选,用于设置界面)
客户端和专用服务器均可使用。仅客户端代码不会在服务器上加载。
安装
- 为 Minecraft 26.3 安装 Fabric Loader 和 Fabric API。
- 下载
zalks-stats-1.4.2.jar。 - 将其放入你的
mods文件夹。 - 启动游戏。
构建
git clone https://github.com/zallkyre/zalks-stats.git
cd zalks-stats
./gradlew build
构建出的 jar 出现在 build/libs/ 中。需要 Java 25 或更新版本。
许可证
已发布至公有领域。参见 LICENSE 文件。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。