HyTari Studios · Officiell konfigurationsguide

Server Diagnostics

Riktade fixes alltid aktiva, tung diagnostik bara vid behov.

Server Diagnostics rättar specifika, validerade fall utan att bli ett generiskt cleanup-system. Rekommenderad profil är aktiv och tyst: automatiska fixes ON, djup diagnostik OFF.

STARTA GUIDEN MODSIDA

INNAN DU BÖRJAR

Kom igång

STEG 01

Installera och starta

Den genererade konfigurationen är redan rekommenderad profil.

STEG 02

Låt fixes vara aktiva

Rotation Fix och Tracker Cleanup är de validerade automatiska modulerna.

STEG 03

Aktivera debug bara vid behov

EntityTracker Diagnostics är ett undersökningsverktyg, inte ett krav.

Server Diagnostics följer fail-open med smala fixes: Osäkra fall lämnas till Hytale istället för generell cleanup.

KAPITEL 01 · 1 EXEMPEL

Produktionsprofil

En ren konfiguration är redo för normal drift.

01PROPERTIES

Rekommenderad produktionsprofil

På en ren installation är validerade fixes aktiva medan tunga verktyg är avstängda.

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

VAD DET GÖR

På en ren installation är validerade fixes aktiva medan tunga verktyg är avstängda.

VIKTIGT BETEENDE

  • dryRun=false betyder att validerad cleanup verkligen är aktiv.
  • Djup diagnostik krävs inte för cleanup.
  • Normalprofilen är designad för låg belastning och lite brus.

KAPITEL 02 · 1 EXEMPEL

Flying NPC Rotation Fix

Rättar endast icke-ändliga NaN/Infinity-rollvärden på konfigurerade flygande modeller.

01PROPERTIES

Rotationsfix för flygande NPC:er

Kontrollerar konfigurerade modeller när de går in i ECS och rättar bara icke-ändliga rotationsvärden.

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

config.properties

VAD DET GÖR

Kontrollerar konfigurerade modeller när de går in i ECS och rättar bara icke-ändliga rotationsvärden.

VIKTIGT BETEENDE

  • Ändrar inte AI, pathfinding, hastighet, spawnregler eller giltiga rotationer.
  • Standardprefixet för aktuella modeller är fortsatt NPC/Flying_.
  • Låt debug vara av om du inte undersöker ett specifikt fall.

KAPITEL 03 · 1 EXEMPEL

Dropped Item Tracker Cleanup

Tar bara bort redan ogiltiga updates som säkert kan kopplas till borttagna dropped items.

01PROPERTIES

EntityTracker-cleanup för dropped items

Körs mellan update-kö och paketsändning, men bara när en ogiltig referens säkert kan kopplas till ett redan borttaget dropped item.

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

config.properties

VAD DET GÖR

Körs mellan update-kö och paketsändning, men bara när en ogiltig referens säkert kan kopplas till ett redan borttaget dropped item.

VIKTIGT BETEENDE

  • Ändrar inte levande dropped items, ItemStacks, antal, pickup/despawn-timers eller giltiga updates.
  • Oväntade förhållanden är fail-open så Hytale hanterar fallet normalt.
  • 300-sekunders sammanfattningen förhindrar spam i produktion.

KAPITEL 04 · 1 EXEMPEL

Djup diagnostik

Endast observationsverktyg för EntityTracker/ECS-undersökningar.

01PROPERTIES

Aktivera djup diagnostik tillfälligt

Vid EntityTracker/ECS-varningar kan observationsmodulen aktiveras.

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

config.properties

VAD DET GÖR

Vid EntityTracker/ECS-varningar kan observationsmodulen aktiveras.

VIKTIGT BETEENDE

  • Kan skapa mycket mer lokal telemetri och större filer.
  • Loggar kontext om ECS-arketyper, komponenter, lifecycle, viewers och korrelationer.
  • Gå tillbaka till minimalprofilen efter undersökningen.

KAPITEL 05 · 1 EXEMPEL

Loggar och lagringstid

En beständig fil per kategori, komprimerad vid start och shutdown.

01PROPERTIES

Lagringstid per kategori

Modden behåller en fil per kategori och tar bort gamla poster ur samma fil.

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

config.properties

VAD DET GÖR

Modden behåller en fil per kategori och tar bort gamla poster ur samma fil.

VIKTIGT BETEENDE

  • Komprimering sker vid initiering och ren shutdown.
  • Den skapar inte oändliga dagsfiler bara för retention.
  • Loggar stannar lokalt och laddas inte upp av modden.

Innan du använder ett exempel

Inga spelarkommandon eller behörigheter krävs.

Loggar kan innehålla nyttig debugkontext; granska dem före publicering.

Cleanup-räknare på noll betyder inte nödvändigtvis att modden inte fungerar; målfallet kanske bara inte har inträffat.

TILL TOPPEN