SparkOsd Changelog / Usage Notes

SparkOsd is a server-side Hytale mod that adds a full-time on-screen TPS/MSPT display using Spark data. Players do not need to install anything client-side. The server sends the HUD automatically when a player joins.

What The OSD Shows

The display shows:

TPS 29.9    MSPT 1.6 avg / 3.8 p95

• TPS shows current server ticks per second.
• MSPT avg shows average milliseconds per tick.
• p95 shows the slowest 5% of server ticks, which is useful for spotting lag spikes.

Color Coding

The OSD changes color based on server health:

• Green: good performance
• Yellow: acceptable performance
• Red: poor performance

Current thresholds:

TPS green: 28+
TPS yellow: 20-27.9
TPS red: below 20

MSPT p95 green: 33 ms or lower
MSPT p95 yellow: 33-50 ms
MSPT p95 red: above 50 ms

Player Commands

Players can control their own OSD with:

/sparkosd --action=on

Turns the OSD on for that player.

/sparkosd --action=off

Turns the OSD off for that player. This is remembered server-side.

/sparkosd --action=status

Prints the current Spark TPS/MSPT values in chat and shows whether that player’s HUD is on or off.

Admin / Utility Commands

/sparkosd --action=refresh

Forces the HUD to refresh immediately.

/sparkosd --action=reload

Reloads the SparkOsd config from JSON. Use this after editing placement, colors, thresholds, or layout values.

Config File

SparkOsd creates its config here:

mods/AipocsHouse_SparkOsd/config.json

The config controls placement, size, spacing, colors, opacity, and performance thresholds. After editing it, run:

/sparkosd --action=reload

Per-player HUD toggle choices are saved in:

mods/AipocsHouse_SparkOsd/players.json