🛠️ SERVER DIAGNOSTICS

ServerDiagnostics is a lightweight server-side utility for Hytale that detects recurring entity-related problems, reduces noisy server warnings and safely fixes specific issues automatically.

ENTITY DIAGNOSTICS • AUTOMATIC FIXES • SAFE CLEANUP • SERVER-SIDE

It works quietly in the background and does not require any client installation.

FEATURES

ENTITYTRACKER CLEANUP
Automatically cleans supported stale EntityTracker updates before Hytale processes them.

CLEANER SERVER LOGS
Helps reduce repeated Removed invalid updates for removed entities warnings.

FLYING NPC ROTATION FIX
Detects and repairs invalid NaN / Infinity rotations on supported flying NPCs.

ENTITYTRACKER DIAGNOSTICS
Provides detailed EntityTracker diagnostics and entity classification.

ENTITY CLASSIFICATION
Can identify dropped items, projectiles, NPCs and other problematic entities.

DETAILED SESSION LOGS
Creates detailed local diagnostic logs for each server session.

MODULAR CONFIGURATION
Each feature can be configured independently.

FAIL-OPEN SAFETY
Uncertain cases are left untouched and handled normally by Hytale.

SAFE BY DESIGN

ServerDiagnostics does not blindly delete entities or hide warnings.

The cleanup system only removes stale tracker updates that can be safely identified.

It does not modify:

LIVE DROPPED ITEMS • ItemStacks • Item quantities • Drop timers

PLAYER INVENTORIES • Valid packets • NPC AI • NPC movement • Valid rotations

If ServerDiagnostics cannot safely identify a problem, Hytale is allowed to handle it normally.

SUPPORTED PROBLEM → SAFE FIX • UNCERTAIN CASE → LEFT UNTOUCHED

SERVER-SIDE ONLY

No client installation is required.

Simply place the JAR inside your server's mods folder and start the server.

The configuration and diagnostic folders are created automatically.

INSTALL. START THE SERVER. SERVERDIAGNOSTICS DOES THE REST.

CONFIGURATION

All features can be configured through:

mods/ServerDiagnostics/config.properties

Default settings are ready for normal production use.

COMPATIBILITY

Hytale Server 0.5.6+ • Compatible with Hytale 0.5.x • Tested on Hytale 0.5.9

Server-side • No database required • No client dependency • No external services or telemetry

ServerDiagnostics focuses on targeted automatic fixes and useful diagnostics while leaving normal gameplay and valid server behavior untouched.