?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
zalk's stats

zalk's stats

Minimal stat tool that logs hardware, TPS, FPS, heap, and player events, so bugs are easier to trace.

205downloads
0followers
205downloads
0followers

Compatibility

Minecraft: Java Edition

26.3
26.2
1.21.11

Platforms

Supported environments

Client-side
Client and server

Links

Report issues View source

Tags

Creators

Details

Licensed CC0-1.0
Published 7 months ago
Updated 3 weeks ago

zalk's stats

A Fabric mod that logs hardware, performance, and player events to the game log, so bugs and performance problems are easier to trace.

What it logs

At startup, once:

  • Environment type (client or server) and mod version
  • Fabric Loader version
  • Java version and VM name
  • OS name, version, and architecture
  • Available processors
  • JVM memory used vs max
  • CPU model, physical/logical core count, and a 1-second CPU load sample
  • Total and available RAM

The hardware probe runs on a background daemon thread, so the one-second CPU load sample no longer stalls game start-up.

Client only:

  • Low-FPS warning when FPS stays at or below your threshold for 10 seconds. Logged once, not spammed.
  • Recovery notice once FPS climbs back to your recovery threshold.
  • FPS summary (average and minimum) on your chosen interval.

Server only:

  • TPS 1m / 5m / 15m on your chosen interval
  • JVM heap usage with per-report delta, on a dedicated server
  • Player join and disconnect events
  • Server start and stop, with uptime

Configuration

Settings live in .minecraft/config/zalks-stats.json and can be edited in-game from the Mod Menu screen. Mod Menu is suggested, not required.

Setting Options Default
Low-FPS warning threshold 10-90 FPS 20
FPS recovery threshold 10-120 FPS 30
FPS summary interval 60, 120, 300, 600, 900 s 300
TPS interval 1, 2, 5, 10, 20, 30 s 5
Heap interval 60, 120, 300, 600, 900 s 300
Log toggles hardware, environment, FPS, TPS, heap, player join/leave, server lifecycle all on

Values are clamped on load and save, so a hand-edited or corrupted config can never leave the mod in a nonsensical state. The recovery threshold is always kept above the warning threshold, so the warning cannot immediately re-arm itself.

Requirements

  • Minecraft 26.3
  • Fabric Loader 0.19.5 or newer
  • Java 25 or newer
  • Fabric API
  • Mod Menu (optional, for the settings screen)

Works on both the client and a dedicated server. Client-only code is not loaded on a server.

Installation

  1. Install Fabric Loader and Fabric API for Minecraft 26.3.
  2. Download zalks-stats-1.4.2.jar.
  3. Put it in your mods folder.
  4. Launch the game.

Building

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

The built jar appears in build/libs/. Java 25 or newer is required.

License

Released into the public domain. See the LICENSE file.