ULTRASTATS

ULTRASTATS is an all-in-one stat tracking, performance analysis, and data collection mod for ULTRAKILL.

The long-term goal of this project is to create a tool that helps players understand how they play: their strengths, weaknesses, habits, and areas for improvement. Whether you speedrun, grind Cybergrind, or just play casually, ULTRASTATS is meant to make your gameplay data useful.

This is a large project and still actively in development, but it already supports logging data from:

Campaign levels
Cybergrind
Custom levels through Angry Level Loader

More data collection and analysis tools are planned for future versions.

Features

Run logging for Campaign and Cybergrind
Optional custom level support through Angry Level Loader
Configurable data folder location
Toggle Campaign logging on or off
Toggle Cybergrind logging on or off
Queued run logging to reduce endscreen overhead
Delete-key hotkey to discard a queued run before it is saved
Async file saving
Main-thread work minimized as much as possible for better long-term performance

Requirements

BepInEx
PluginConfigurator
Angry Level Loader (optional, only needed for custom level support)

Installation

Install PluginConfigurator.
Download ULTRASTATS.
Place the ULTRASTATS folder or plugin files into:

ULTRAKILL\BepInEx\plugins\
Launch ULTRAKILL.
Check the BepInEx console/log and make sure you see lines like:

[Info : BepInEx] Loading [ULTRASTATS 0.0.9] [Info :ULTRASTATS] ULTRASTATS loaded!

Play a Campaign level and/or Cybergrind run.
ULTRASTATS should automatically create and append data to .jsonl log files.

Data Folder

By default, ULTRASTATS stores data in:

%appdata%\Roaming\AtomSmasher1586\ULTRASTATS

You can also choose a custom filepath for the ULTRASTATS data folder through PluginConfigurator.

File Structure:

ULTRASTATS organizes data primarily by difficulty, then by layer.

Example:

Reading .jsonl Files Manually

ULTRASTATS stores run data in .jsonl format. Each line is one logged run.

Shared fields S = Save file ID = Run ID T = Unix time of run completion t = Run elapsed time in milliseconds k = Number of kills s = Style points r = Number of restarts F = Run flags 1 = Major assists 2 = Cheats enabled Cybergrind-only w = Wave reached the last two digits represent percent completion of that wave Campaign-only p = P earned rs = Rank string (time-kills-style) rt = Total rank td = Took damage (true / false) c = Challenge completed (true / false) Feedback / Contact

Discord: atomsmasher_1586

If you use ULTRASTATS, I would really appreciate hearing from you.

Please DM me if you:

use the mod regularly speedrun play Cybergrind play casually find bugs have suggestions for features or improvements

The more real player data and feedback I have, the better I can make ULTRASTATS.