HyTari Studios · Offizielle Konfigurationsanleitung

Server Diagnostics

Gezielte Fixes immer aktiv, aufwendige Diagnose nur bei Bedarf.

Server Diagnostics korrigiert spezifische, validierte FĂ€lle, ohne zu einem generischen Cleanup-System zu werden. Das empfohlene Profil ist aktiv und leise: automatische Fixes ON, tiefe Diagnose OFF.

ANLEITUNG STARTEN MOD-SEITE

BEVOR DU BEGINNST

Erste Schritte

SCHRITT 01

Installieren und starten

Die erzeugte Konfiguration ist bereits das empfohlene Profil.

SCHRITT 02

Fixes aktiviert lassen

Rotation Fix und Tracker Cleanup sind die validierten automatischen Module.

SCHRITT 03

Debug nur bei Bedarf aktivieren

EntityTracker Diagnostics ist ein Untersuchungswerkzeug, keine Voraussetzung.

Server Diagnostics folgt einer Fail-open-Philosophie mit eng begrenzten Fixes: Unsichere FĂ€lle werden Hytale ĂŒberlassen statt generisch bereinigt.

KAPITEL 01 · 1 BEISPIELE

Produktionsprofil

Eine saubere Konfiguration ist bereits fĂŒr den normalen Betrieb bereit.

01PROPERTIES

Empfohlenes Produktionsprofil

Bei einer sauberen Installation sind validierte Fixes aktiv, wÀhrend teure Werkzeuge deaktiviert bleiben.

PROPERTIES
enabled=true

module.flyingNpcRotationFix.enabled=true
module.flyingNpcRotationFix.debug=false

module.droppedItemTrackerCleanup.enabled=true
module.droppedItemTrackerCleanup.dryRun=false

module.entityTrackerDiagnostics.enabled=false
module.entityTrackerDiagnostics.debug=false

mods/ServerDiagnostics/config.properties

WAS ES MACHT

Bei einer sauberen Installation sind validierte Fixes aktiv, wÀhrend teure Werkzeuge deaktiviert bleiben.

WICHTIGES VERHALTEN

  • dryRun=false bedeutet, dass der validierte Cleanup wirklich aktiv ist.
  • Tiefe Diagnose ist fĂŒr den Cleanup nicht erforderlich.
  • Das normale Profil ist auf geringe Last und wenig Ausgabe ausgelegt.

KAPITEL 02 · 1 BEISPIELE

Flying NPC Rotation Fix

Repariert nur nicht-endliche NaN/Infinity-Rollwerte bei konfigurierten Flugmodellen.

01PROPERTIES

Korrektur der Rotation fliegender NPCs

PrĂŒft konfigurierte Modelle beim Eintritt in ECS und repariert nur nicht-endliche Rotationswerte.

PROPERTIES
module.flyingNpcRotationFix.enabled=true
module.flyingNpcRotationFix.debug=false

config.properties

WAS ES MACHT

PrĂŒft konfigurierte Modelle beim Eintritt in ECS und repariert nur nicht-endliche Rotationswerte.

WICHTIGES VERHALTEN

  • AI, Pathfinding, Geschwindigkeit, Spawn-Regeln und gĂŒltige Rotationen werden nicht verĂ€ndert.
  • Der StandardprĂ€fix geeigneter Modelle bleibt NPC/Flying_.
  • Lass Debug aus, sofern du keinen konkreten Fall untersuchst.

KAPITEL 03 · 1 BEISPIELE

Dropped Item Tracker Cleanup

Entfernt nur bereits ungĂŒltige Updates, die sicher entfernten Dropped Items zugeordnet werden können.

01PROPERTIES

EntityTracker-Cleanup fĂŒr Dropped Items

LĂ€uft zwischen Update-Queue und Paketversand, aber nur wenn eine ungĂŒltige Referenz sicher einem bereits entfernten Dropped Item zugeordnet werden kann.

PROPERTIES
module.droppedItemTrackerCleanup.enabled=true
module.droppedItemTrackerCleanup.dryRun=false
module.droppedItemTrackerCleanup.logToFile=true
module.droppedItemTrackerCleanup.summaryIntervalSeconds=300

config.properties

WAS ES MACHT

LĂ€uft zwischen Update-Queue und Paketversand, aber nur wenn eine ungĂŒltige Referenz sicher einem bereits entfernten Dropped Item zugeordnet werden kann.

WICHTIGES VERHALTEN

  • Lebende Dropped Items, ItemStacks, Mengen, Pickup-/Despawn-Timer und gĂŒltige Updates werden nicht verĂ€ndert.
  • Unerwartete Bedingungen sind fail-open, sodass Hytale den Fall normal behandelt.
  • Das 300-Sekunden-Intervall verhindert Spam im Produktionsbetrieb.

KAPITEL 04 · 1 BEISPIELE

Tiefe Diagnose

Reine Beobachtungswerkzeuge fĂŒr EntityTracker/ECS-Untersuchungen.

01PROPERTIES

Tiefe Diagnose nur vorĂŒbergehend aktivieren

FĂŒr EntityTracker/ECS-Warnungen kann das reine Beobachtungsmodul aktiviert werden.

PROPERTIES
module.entityTrackerDiagnostics.enabled=true
module.entityTrackerDiagnostics.debug=true

config.properties

WAS ES MACHT

FĂŒr EntityTracker/ECS-Warnungen kann das reine Beobachtungsmodul aktiviert werden.

WICHTIGES VERHALTEN

  • Es kann deutlich mehr lokale Telemetrie und grĂ¶ĂŸere Dateien erzeugen.
  • Es erfasst Kontext zu ECS-Archetypen, Komponenten, Lifecycle, Viewern und Korrelationen.
  • Nach der Untersuchung sollte wieder das Minimalprofil verwendet werden.

KAPITEL 05 · 1 BEISPIELE

Logs und Aufbewahrung

Eine persistente Datei pro Kategorie, kompaktiert bei Start und Shutdown.

01PROPERTIES

Aufbewahrung pro Kategorie

Die Mod hÀlt eine Datei pro Kategorie und entfernt alte DatensÀtze aus derselben Datei.

PROPERTIES
logs.retention.enabled=true
logs.retention.entityTrackerDays=3
logs.retention.entityArchetypesDays=5
logs.retention.dropTrackerCleanupDays=3
logs.retention.flyingNpcRotationDays=5

config.properties

WAS ES MACHT

Die Mod hÀlt eine Datei pro Kategorie und entfernt alte DatensÀtze aus derselben Datei.

WICHTIGES VERHALTEN

  • Kompaktierung lĂ€uft bei Initialisierung und sauberem Shutdown.
  • Es werden nicht endlos tĂ€gliche Dateien nur fĂŒr die Aufbewahrung erzeugt.
  • Logs bleiben lokal auf dem Server und werden von der Mod nicht hochgeladen.

Vor der Verwendung eines Beispiels

Es sind keine Spielerbefehle oder Berechtigungen erforderlich.

Logs können nĂŒtzlichen Debug-Kontext enthalten; prĂŒfe sie vor Veröffentlichung.

Cleanup-ZĂ€hler von null bedeuten nicht zwingend, dass die Mod nicht funktioniert; der Zielzustand kann schlicht nicht aufgetreten sein.

NACH OBEN