HyTari Studios · Virallinen määritysopas

Server Diagnostics

Kohdistetut korjaukset aina käytössä, raskas diagnostiikka vain tarvittaessa.

Server Diagnostics korjaa tarkasti rajattuja ja validoituja tapauksia muuttumatta yleiseksi cleanup-järjestelmäksi. Suositusprofiili on toimiva ja hiljainen: automaattikorjaukset ON, syvä diagnostiikka OFF.

ALOITA OPAS MOD-SIVU

ENNEN KUIN ALOITAT

Aloitus

VAIHE 01

Asenna ja käynnistä

Luotu määritys on jo suositeltu profiili.

VAIHE 02

Pidä korjaukset käytössä

Rotation Fix ja Tracker Cleanup ovat validoidut automaattimoduulit.

VAIHE 03

Ota debug käyttöön vain tarvittaessa

EntityTracker Diagnostics on tutkimustyökalu, ei vaatimus.

Server Diagnostics käyttää fail-open-periaatetta ja tarkkoja korjauksia: epävarmat tapaukset jätetään Hytalelle yleisen cleanupin sijaan.

LUKU 01 · 1 ESIMERKIT

Tuotantoprofiili

Puhdas määritys on heti valmis normaaliin käyttöön.

01PROPERTIES

Suositeltu tuotantoprofiili

Puhtaassa asennuksessa validoidut korjaukset ovat aktiivisia ja raskaat työkalut pois käytöstä.

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

MITÄ SE TEKEE

Puhtaassa asennuksessa validoidut korjaukset ovat aktiivisia ja raskaat työkalut pois käytöstä.

TÄRKEÄ TOIMINTA

  • dryRun=false tarkoittaa, että validoitu cleanup on oikeasti aktiivinen.
  • Syvä diagnostiikka ei ole cleanupin vaatimus.
  • Normaaliprofiili on suunniteltu kevyeksi ja hiljaiseksi.

LUKU 02 · 1 ESIMERKIT

Flying NPC Rotation Fix

Korjaa vain ei-äärelliset NaN/Infinity-roll-arvot määritetyissä lentävissä malleissa.

01PROPERTIES

Lentävien NPC:iden rotaatiokorjaus

Tarkistaa määritetyt mallit niiden tullessa ECS:ään ja korjaa vain ei-äärelliset rotaatioarvot.

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

config.properties

MITÄ SE TEKEE

Tarkistaa määritetyt mallit niiden tullessa ECS:ään ja korjaa vain ei-äärelliset rotaatioarvot.

TÄRKEÄ TOIMINTA

  • Ei muuta AI:ta, pathfindingia, nopeutta, spawn-sääntöjä tai kelvollisia rotaatioita.
  • Kelvollisen mallin oletusprefiksi on edelleen NPC/Flying_.
  • Pidä debug pois, ellet tutki tiettyä tapausta.

LUKU 03 · 1 ESIMERKIT

Dropped Item Tracker Cleanup

Poistaa vain jo virheelliset updatet, jotka voidaan turvallisesti yhdistää poistettuihin dropped itemeihin.

01PROPERTIES

EntityTracker-cleanup dropped itemeille

Toimii update-jonon ja pakettien lähetyksen välissä, mutta vain kun virheellinen viite voidaan turvallisesti yhdistää jo poistettuun dropped itemiin.

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

config.properties

MITÄ SE TEKEE

Toimii update-jonon ja pakettien lähetyksen välissä, mutta vain kun virheellinen viite voidaan turvallisesti yhdistää jo poistettuun dropped itemiin.

TÄRKEÄ TOIMINTA

  • Ei muuta eläviä dropped itemeitä, ItemStackeja, määriä, pickup/despawn-ajastimia tai kelvollisia updateja.
  • Odottamattomat tilanteet ovat fail-open, joten Hytale käsittelee tapauksen normaalisti.
  • 300 sekunnin yhteenveto estää tuotantospämmin.

LUKU 04 · 1 ESIMERKIT

Syvä diagnostiikka

Vain havainnointiin tarkoitetut työkalut EntityTracker/ECS-tutkimuksiin.

01PROPERTIES

Ota syvä diagnostiikka käyttöön vain tilapäisesti

EntityTracker/ECS-varoituksia tutkittaessa havainnointimoduuli voidaan aktivoida.

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

config.properties

MITÄ SE TEKEE

EntityTracker/ECS-varoituksia tutkittaessa havainnointimoduuli voidaan aktivoida.

TÄRKEÄ TOIMINTA

  • Se voi tuottaa paljon enemmän paikallista telemetriaa ja suurempia tiedostoja.
  • Se kirjaa kontekstia ECS-arkkityypeistä, komponenteista, lifecyclestä, viewereistä ja korrelaatioista.
  • Tutkimuksen jälkeen palaa minimiprofiiliin.

LUKU 05 · 1 ESIMERKIT

Lokit ja säilytys

Yksi pysyvä tiedosto per kategoria, tiivistetään käynnistyksessä ja shutdownissa.

01PROPERTIES

Säilytys kategorioittain

Modi pitää yhden tiedoston per kategoria ja poistaa vanhat tietueet samasta tiedostosta.

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

config.properties

MITÄ SE TEKEE

Modi pitää yhden tiedoston per kategoria ja poistaa vanhat tietueet samasta tiedostosta.

TÄRKEÄ TOIMINTA

  • Tiivistys tapahtuu alustuksessa ja siistissä shutdownissa.
  • Loputtomia päiväkohtaisia tiedostoja ei luoda vain säilytystä varten.
  • Lokit pysyvät paikallisesti palvelimella eikä modi lähetä niitä.

Ennen esimerkin käyttöä

Pelaajakomentoja tai oikeuksia ei tarvita.

Lokit voivat sisältää hyödyllistä debug-kontekstia; tarkista ne ennen julkaisemista.

Nollassa pysyvät cleanup-laskurit eivät välttämättä tarkoita vikaa; kohdetapausta ei ehkä ole tapahtunut.

TAKAISIN YLÖS