HyTari Studios · Oficjalny poradnik konfiguracji

Server Diagnostics

Ukierunkowane poprawki zawsze aktywne, ciężka diagnostyka tylko w razie potrzeby.

Server Diagnostics naprawia konkretne, zweryfikowane przypadki bez stawania się ogólnym systemem cleanup. Zalecany profil jest aktywny i cichy: automatyczne poprawki ON, głęboka diagnostyka OFF.

ROZPOCZNIJ PORADNIK STRONA MODA

ZANIM ZACZNIESZ

Pierwsze kroki

KROK 01

Zainstaluj i uruchom

Wygenerowana konfiguracja jest już zalecanym profilem.

KROK 02

Pozostaw poprawki aktywne

Rotation Fix i Tracker Cleanup to zweryfikowane moduły automatyczne.

KROK 03

Włącz debug tylko w razie potrzeby

EntityTracker Diagnostics to narzędzie diagnostyczne, nie wymóg.

Server Diagnostics stosuje fail-open i wąskie poprawki: niepewne przypadki pozostawia Hytale zamiast wykonywać ogólny cleanup.

ROZDZIAŁ 01 · 1 PRZYKŁADY

Profil produkcyjny

Czysta konfiguracja jest gotowa do normalnej pracy.

01PROPERTIES

Zalecany profil produkcyjny

W czystej instalacji zweryfikowane poprawki są aktywne, a ciężkie narzędzia wyłączone.

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

CO TO ROBI

W czystej instalacji zweryfikowane poprawki są aktywne, a ciężkie narzędzia wyłączone.

WAŻNE DZIAŁANIE

  • dryRun=false oznacza, że zweryfikowany cleanup faktycznie działa.
  • Głęboka diagnostyka nie jest potrzebna do cleanup.
  • Profil normalny zaprojektowano jako lekki i cichy.

ROZDZIAŁ 02 · 1 PRZYKŁADY

Flying NPC Rotation Fix

Naprawia tylko niekończone wartości roll NaN/Infinity w skonfigurowanych modelach latających.

01PROPERTIES

Korekta rotacji latających NPC

Sprawdza skonfigurowane modele przy wejściu do ECS i naprawia tylko niekończone wartości rotacji.

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

config.properties

CO TO ROBI

Sprawdza skonfigurowane modele przy wejściu do ECS i naprawia tylko niekończone wartości rotacji.

WAŻNE DZIAŁANIE

  • Nie zmienia AI, pathfindingu, prędkości, reguł spawnu ani poprawnych rotacji.
  • Domyślny prefiks kwalifikujących się modeli pozostaje NPC/Flying_.
  • Pozostaw debug wyłączony, jeśli nie analizujesz konkretnego przypadku.

ROZDZIAŁ 03 · 1 PRZYKŁADY

Dropped Item Tracker Cleanup

Usuwa tylko już nieprawidłowe updates, które można bezpiecznie powiązać z usuniętymi dropped item.

01PROPERTIES

EntityTracker cleanup dla dropped item

Działa pomiędzy kolejką update a wysyłką pakietów, ale tylko gdy nieprawidłowe odwołanie można bezpiecznie powiązać z już usuniętym dropped item.

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

config.properties

CO TO ROBI

Działa pomiędzy kolejką update a wysyłką pakietów, ale tylko gdy nieprawidłowe odwołanie można bezpiecznie powiązać z już usuniętym dropped item.

WAŻNE DZIAŁANIE

  • Nie zmienia żywych dropped item, ItemStack, ilości, timerów pickup/despawn ani poprawnych updates.
  • Nieoczekiwane warunki są fail-open, więc Hytale obsługuje przypadek normalnie.
  • Podsumowanie co 300 sekund ogranicza spam produkcyjny.

ROZDZIAŁ 04 · 1 PRZYKŁADY

Głęboka diagnostyka

Narzędzia tylko obserwacyjne do analiz EntityTracker/ECS.

01PROPERTIES

Włączaj głęboką diagnostykę tymczasowo

Podczas analizy ostrzeżeń EntityTracker/ECS można włączyć moduł obserwacyjny.

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

config.properties

CO TO ROBI

Podczas analizy ostrzeżeń EntityTracker/ECS można włączyć moduł obserwacyjny.

WAŻNE DZIAŁANIE

  • Może generować znacznie więcej lokalnej telemetrii i większe pliki.
  • Rejestruje kontekst archetypów ECS, komponentów, lifecycle, viewers i korelacji.
  • Po analizie wróć do profilu minimalnego.

ROZDZIAŁ 05 · 1 PRZYKŁADY

Logi i retencja

Jeden trwały plik na kategorię, kompakowany przy starcie i shutdown.

01PROPERTIES

Retencja per kategoria

Mod utrzymuje jeden plik na kategorię i usuwa stare wpisy z tego samego pliku.

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

config.properties

CO TO ROBI

Mod utrzymuje jeden plik na kategorię i usuwa stare wpisy z tego samego pliku.

WAŻNE DZIAŁANIE

  • Kompakcja odbywa się podczas inicjalizacji i czystego shutdown.
  • Nie tworzy nieskończonych plików dziennych tylko dla retencji.
  • Logi pozostają lokalne i nie są wysyłane przez mod.

Przed użyciem przykładu

Nie są wymagane komendy ani uprawnienia graczy.

Logi mogą zawierać przydatny kontekst debug; sprawdź je przed publikacją.

Zerowe liczniki cleanup nie muszą oznaczać problemu — przypadek docelowy mógł po prostu nie wystąpić.

DO GÓRY