HyTari Studios · Officiel konfigurationsguide

Server Diagnostics

Målrettede fixes altid aktive, tung diagnostik kun når nødvendigt.

Server Diagnostics retter specifikke, validerede tilfælde uden at blive et generisk cleanup-system. Den anbefalede profil er aktiv og stille: automatiske fixes ON, dyb diagnostik OFF.

START GUIDEN MODSIDE

FØR DU BEGYNDER

Kom godt i gang

TRIN 01

Installer og start

Den genererede konfiguration er allerede den anbefalede profil.

TRIN 02

Lad fixes være aktive

Rotation Fix og Tracker Cleanup er de validerede automatiske moduler.

TRIN 03

Aktivér debug kun ved behov

EntityTracker Diagnostics er et undersøgelsesværktøj, ikke et krav.

Server Diagnostics følger en fail-open-filosofi med snævre fixes: Usikre tilfælde overlades til Hytale i stedet for generisk cleanup.

KAPITEL 01 · 1 EKSEMPLER

Produktionsprofil

En ren konfiguration er klar til normal drift.

01PROPERTIES

Anbefalet produktionsprofil

På en ren installation er de validerede fixes aktive, mens tunge værktøjer er slået fra.

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

HVAD DET GØR

På en ren installation er de validerede fixes aktive, mens tunge værktøjer er slået fra.

VIGTIG ADFÆRD

  • dryRun=false betyder, at den validerede cleanup faktisk er aktiv.
  • Dyb diagnostik er ikke nødvendig for cleanup.
  • Normalprofilen er designet til lav belastning og lidt støj.

KAPITEL 02 · 1 EKSEMPLER

Flying NPC Rotation Fix

Retter kun ikke-endelige NaN/Infinity-rollværdier på konfigurerede flyvende modeller.

01PROPERTIES

Rotationsfix til flyvende NPC'er

Kontrollerer konfigurerede modeller ved indtræden i ECS og retter kun ikke-endelige rotationsværdier.

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

config.properties

HVAD DET GØR

Kontrollerer konfigurerede modeller ved indtræden i ECS og retter kun ikke-endelige rotationsværdier.

VIGTIG ADFÆRD

  • Ændrer ikke AI, pathfinding, hastighed, spawn-regler eller gyldige rotationer.
  • Standardpræfikset for relevante modeller er fortsat NPC/Flying_.
  • Lad debug være slukket, medmindre du undersøger en bestemt sag.

KAPITEL 03 · 1 EKSEMPLER

Dropped Item Tracker Cleanup

Fjerner kun allerede ugyldige updates, der sikkert kan knyttes til fjernede dropped items.

01PROPERTIES

EntityTracker-cleanup for dropped items

Kører mellem update-kø og pakkesending, men kun når en ugyldig reference sikkert kan knyttes til et allerede fjernet dropped item.

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

config.properties

HVAD DET GØR

Kører mellem update-kø og pakkesending, men kun når en ugyldig reference sikkert kan knyttes til et allerede fjernet dropped item.

VIGTIG ADFÆRD

  • Ændrer ikke levende dropped items, ItemStacks, antal, pickup/despawn-timere eller gyldige updates.
  • Uventede forhold er fail-open, så Hytale håndterer sagen normalt.
  • 300-sekunders oversigten undgår spam i produktion.

KAPITEL 04 · 1 EKSEMPLER

Dyb diagnostik

Kun observationsværktøjer til EntityTracker/ECS-undersøgelser.

01PROPERTIES

Aktivér dyb diagnostik midlertidigt

Ved EntityTracker/ECS-advarsler kan observationsmodulet aktiveres.

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

config.properties

HVAD DET GØR

Ved EntityTracker/ECS-advarsler kan observationsmodulet aktiveres.

VIGTIG ADFÆRD

  • Det kan producere langt mere lokal telemetri og større filer.
  • Det registrerer kontekst om ECS-arketyper, komponenter, lifecycle, viewers og korrelationer.
  • Efter undersøgelsen bør du gå tilbage til minimalprofilen.

KAPITEL 05 · 1 EKSEMPLER

Logs og retention

Én vedvarende fil pr. kategori, komprimeret ved start og shutdown.

01PROPERTIES

Retention pr. kategori

Modden beholder én fil pr. kategori og fjerner gamle poster fra samme fil.

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

config.properties

HVAD DET GØR

Modden beholder én fil pr. kategori og fjerner gamle poster fra samme fil.

VIGTIG ADFÆRD

  • Komprimering sker ved initialisering og ren shutdown.
  • Der oprettes ikke endeløse dagsfiler kun for retention.
  • Logs forbliver lokale og uploades ikke af modden.

Før du bruger et eksempel

Ingen spillerkommandoer eller tilladelser kræves.

Logs kan indeholde nyttig debugkontekst; gennemgå dem før offentliggørelse.

Cleanup-tællere på nul betyder ikke nødvendigvis, at modden ikke virker; måltilfældet er måske bare ikke opstået.

TIL TOPPEN