HyTari Studios · Hivatalos konfigurációs útmutató

Server Diagnostics

Célzott javítások mindig aktívak, nehéz diagnosztika csak szükség esetén.

A Server Diagnostics konkrét, validált eseteket javít anélkül, hogy általános cleanup rendszerré válna. Az ajánlott profil működő és csendes: automatikus javítások ON, mély diagnosztika OFF.

ÚTMUTATÓ INDÍTÁSA MOD OLDALA

MIELŐTT ELKEZDED

Első lépések

LÉPÉS 01

Telepítés és indítás

A generált konfiguráció már az ajánlott profil.

LÉPÉS 02

A javítások maradjanak aktívak

A Rotation Fix és Tracker Cleanup validált automatikus modulok.

LÉPÉS 03

Debug csak szükség esetén

Az EntityTracker Diagnostics vizsgálati eszköz, nem követelmény.

A Server Diagnostics fail-open elvet és szűk javításokat használ: a bizonytalan eseteket Hytale kezeli általános cleanup helyett.

FEJEZET 01 · 1 PÉLDÁK

Production profil

A tiszta konfiguráció azonnal használható normál üzemre.

01PROPERTIES

Ajánlott production profil

Tiszta telepítésnél a validált javítások aktívak, a nehéz eszközök kikapcsoltak.

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 CSINÁL

Tiszta telepítésnél a validált javítások aktívak, a nehéz eszközök kikapcsoltak.

FONTOS MŰKÖDÉS

  • A dryRun=false azt jelenti, hogy a validált cleanup ténylegesen aktív.
  • A mély diagnosztika nem szükséges a cleanuphoz.
  • A normál profil alacsony terhelésre és kevés zajra készült.

FEJEZET 02 · 1 PÉLDÁK

Flying NPC Rotation Fix

Csak a nem véges NaN/Infinity roll értékeket javítja a konfigurált repülő modelleken.

01PROPERTIES

Repülő NPC rotáció javítása

Az ECS-be belépő konfigurált modelleket ellenőrzi és csak a nem véges rotációs értékeket javítja.

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

config.properties

MIT CSINÁL

Az ECS-be belépő konfigurált modelleket ellenőrzi és csak a nem véges rotációs értékeket javítja.

FONTOS MŰKÖDÉS

  • Nem módosít AI-t, pathfindingot, sebességet, spawn-szabályt vagy érvényes rotációt.
  • Az alapértelmezett megfelelő modellprefix továbbra is NPC/Flying_.
  • Tartsd kikapcsolva a debugot, ha nem konkrét esetet vizsgálsz.

FEJEZET 03 · 1 PÉLDÁK

Dropped Item Tracker Cleanup

Csak azokat a már érvénytelen update-eket távolítja el, amelyek biztonságosan kapcsolhatók eltávolított dropped itemhez.

01PROPERTIES

EntityTracker cleanup dropped itemhez

Az update queue és csomagküldés között fut, de csak ha az érvénytelen referencia biztonságosan egy már eltávolított dropped itemhez köthető.

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

config.properties

MIT CSINÁL

Az update queue és csomagküldés között fut, de csak ha az érvénytelen referencia biztonságosan egy már eltávolított dropped itemhez köthető.

FONTOS MŰKÖDÉS

  • Nem módosít élő dropped itemet, ItemStackot, mennyiséget, pickup/despawn timert vagy érvényes update-et.
  • Váratlan feltételeknél fail-open, így Hytale normálisan kezeli az esetet.
  • A 300 másodperces összegzés megelőzi a production spamet.

FEJEZET 04 · 1 PÉLDÁK

Mély diagnosztika

Csak megfigyelő eszközök EntityTracker/ECS vizsgálatokhoz.

01PROPERTIES

Mély diagnosztika csak ideiglenesen

EntityTracker/ECS figyelmeztetések vizsgálatakor bekapcsolható a megfigyelő modul.

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

config.properties

MIT CSINÁL

EntityTracker/ECS figyelmeztetések vizsgálatakor bekapcsolható a megfigyelő modul.

FONTOS MŰKÖDÉS

  • Sokkal több helyi telemetriát és nagyobb fájlokat hozhat létre.
  • ECS archetípusokról, komponensekről, lifecycle-ről, viewerekről és korrelációkról rögzít kontextust.
  • Vizsgálat után térj vissza a minimálprofilhoz.

FEJEZET 05 · 1 PÉLDÁK

Naplók és megőrzés

Kategóriánként egy tartós fájl, induláskor és shutdownkor tömörítve.

01PROPERTIES

Megőrzés kategóriánként

A mod kategóriánként egy fájlt tart meg és abból törli a régi rekordokat.

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

config.properties

MIT CSINÁL

A mod kategóriánként egy fájlt tart meg és abból törli a régi rekordokat.

FONTOS MŰKÖDÉS

  • A tömörítés inicializáláskor és tiszta shutdownkor fut.
  • Nem készül végtelen napi fájl csak a retention miatt.
  • A naplók helyben maradnak, a mod nem tölti fel őket.

Példa használata előtt

Nem szükséges játékosparancs vagy jogosultság.

A naplók hasznos debug-kontextust tartalmazhatnak; közzététel előtt ellenőrizd őket.

A nulla cleanup számláló nem feltétlen hibát jelent; a célzott eset lehet, hogy nem történt meg.

VISSZA FEL