HyTari Studios · Offisiell konfigurasjonsguide

Server Diagnostics

Målrettede fixes alltid aktive, tung diagnostikk bare ved behov.

Server Diagnostics retter spesifikke, validerte tilfeller uten å bli et generisk cleanup-system. Anbefalt profil er aktiv og stille: automatiske fixes ON, dyp diagnostikk OFF.

START GUIDEN MODSIDE

FØR DU BEGYNNER

Kom i gang

TRINN 01

Installer og start

Generert konfigurasjon er allerede anbefalt profil.

TRINN 02

La fixes være aktive

Rotation Fix og Tracker Cleanup er validerte automatiske moduler.

TRINN 03

Aktiver debug bare ved behov

EntityTracker Diagnostics er et undersøkelsesverktøy, ikke et krav.

Server Diagnostics følger fail-open med smale fixes: Usikre tilfeller overlates til Hytale i stedet for generisk cleanup.

KAPITTEL 01 · 1 EKSEMPLER

Produksjonsprofil

En ren konfigurasjon er klar for normal drift.

01PROPERTIES

Anbefalt produksjonsprofil

På en ren installasjon er validerte fixes aktive mens tunge verktøy er av.

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

HVA DET GJØR

På en ren installasjon er validerte fixes aktive mens tunge verktøy er av.

VIKTIG ATFERD

  • dryRun=false betyr at validert cleanup faktisk er aktiv.
  • Dyp diagnostikk er ikke nødvendig for cleanup.
  • Normalprofilen er laget for lav belastning og lite støy.

KAPITTEL 02 · 1 EKSEMPLER

Flying NPC Rotation Fix

Retter bare ikke-endelige NaN/Infinity-rollverdier på konfigurerte flygende modeller.

01PROPERTIES

Rotasjonsfix for flygende NPC-er

Kontrollerer konfigurerte modeller når de går inn i ECS og retter bare ikke-endelige rotasjonsverdier.

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

config.properties

HVA DET GJØR

Kontrollerer konfigurerte modeller når de går inn i ECS og retter bare ikke-endelige rotasjonsverdier.

VIKTIG ATFERD

  • Endrer ikke AI, pathfinding, hastighet, spawn-regler eller gyldige rotasjoner.
  • Standardprefikset for aktuelle modeller er fortsatt NPC/Flying_.
  • La debug være av med mindre du undersøker et konkret tilfelle.

KAPITTEL 03 · 1 EKSEMPLER

Dropped Item Tracker Cleanup

Fjerner bare allerede ugyldige updates som trygt kan knyttes til fjernede dropped items.

01PROPERTIES

EntityTracker-cleanup for dropped items

Kjører mellom update-kø og pakkesending, men bare når en ugyldig referanse trygt 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

HVA DET GJØR

Kjører mellom update-kø og pakkesending, men bare når en ugyldig referanse trygt kan knyttes til et allerede fjernet dropped item.

VIKTIG ATFERD

  • Endrer ikke levende dropped items, ItemStacks, antall, pickup/despawn-timere eller gyldige updates.
  • Uventede forhold er fail-open slik at Hytale håndterer tilfellet normalt.
  • 300-sekunders sammendrag hindrer spam i produksjon.

KAPITTEL 04 · 1 EKSEMPLER

Dyp diagnostikk

Kun observasjonsverktøy for EntityTracker/ECS-undersøkelser.

01PROPERTIES

Aktiver dyp diagnostikk midlertidig

Ved EntityTracker/ECS-advarsler kan observasjonsmodulen aktiveres.

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

config.properties

HVA DET GJØR

Ved EntityTracker/ECS-advarsler kan observasjonsmodulen aktiveres.

VIKTIG ATFERD

  • Kan produsere langt mer lokal telemetri og større filer.
  • Registrerer kontekst om ECS-arketyper, komponenter, lifecycle, viewers og korrelasjoner.
  • Gå tilbake til minimalprofilen etter undersøkelsen.

KAPITTEL 05 · 1 EKSEMPLER

Logger og oppbevaring

Én vedvarende fil per kategori, komprimert ved start og shutdown.

01PROPERTIES

Oppbevaring per kategori

Modden bruker én fil per 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

HVA DET GJØR

Modden bruker én fil per kategori og fjerner gamle poster fra samme fil.

VIKTIG ATFERD

  • Komprimering skjer ved initialisering og ren shutdown.
  • Det opprettes ikke endeløse daglige filer bare for oppbevaring.
  • Logger forblir lokale og lastes ikke opp av modden.

Før du bruker et eksempel

Ingen spillerkommandoer eller tillatelser kreves.

Logger kan inneholde nyttig debugkontekst; gjennomgå dem før publisering.

Cleanup-tellere på null betyr ikke nødvendigvis at modden ikke virker; måltilfellet kan ganske enkelt ikke ha oppstått.

TIL TOPPEN