Server Diagnostics
- By
Detect, diagnose and safely fix recurring Hytale server entity errors. ServerDiagnostics reduces noisy EntityTracker warnings, repairs invalid flying NPC rotations and provides detailed server-side diagnostics.
Compare noisy server errors with ServerDiagnostics actively detecting invalid updates and applying targeted fixes for a cleaner, more stable server.
Fine-tune automatic fixes, optional deep diagnostics, and log retention directly from the ServerDiagnostics configuration file.
ServerDiagnostics keeps dedicated log files for each diagnostic category, making troubleshooting and long-term server monitoring easier.
Description
🛠️ SERVER DIAGNOSTICS
ServerDiagnostics is a lightweight server-side utility for Hytale that automatically fixes specific entity-related issues and keeps your server logs cleaner.
AUTOMATIC FIXES • SAFE CLEANUP • LIGHTWEIGHT • SERVER-SIDE
It works quietly in the background and requires no client installation.
FEATURES
ENTITYTRACKER CLEANUP Automatically removes supported stale entity updates before Hytale processes them.
CLEANER SERVER LOGS Greatly reduces repeated Removed invalid updates for removed entities warnings.
FLYING NPC ROTATION FIX Detects and repairs invalid NaN or Infinity rotations on supported flying NPCs.
ENTITY DIAGNOSTICS Optional diagnostic tools are available when deeper investigation is needed.
LIGHTWEIGHT LOGGING Uses persistent log files with automatic retention. Old entries are removed according to the configured number of days.
READY BY DEFAULT Automatic fixes are enabled out of the box while heavy diagnostics and debug logging remain disabled.
FAIL-OPEN SAFETY If a case cannot be safely identified, ServerDiagnostics leaves it untouched and lets Hytale handle it normally.
SAFE BY DESIGN
ServerDiagnostics does not blindly delete entities or hide warnings.
Its 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
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.
ServerDiagnostics creates its configuration and log folders automatically.
INSTALL. START THE SERVER. SERVERDIAGNOSTICS DOES THE REST.
CONFIGURATION
Configuration is available through:
mods/ServerDiagnostics/config.properties
The default settings are already prepared for normal production use.
COMPATIBILITY
Hytale Server 0.6.x
Server-side • No database required • No client dependency • No external services or telemetry
ServerDiagnostics focuses on safe automatic fixes, low overhead and useful diagnostics while leaving normal gameplay and valid server behavior untouched.
Server Diagnostics Team
