扎尔克的属性

扎尔克的属性

用于记录硬件、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(可选,用于设置界面)

客户端和专用服务器均可使用。仅客户端代码不会在服务器上加载。

安装

  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 文件。