HyTari Studios · Ghid oficial de configurare

Server Diagnostics

Fixuri țintite mereu active, diagnostic greu doar când este necesar.

Server Diagnostics corectează cazuri specifice și validate fără să devină un sistem generic de cleanup. Profilul recomandat este activ și silențios: fixuri automate ON, diagnostic profund OFF.

PORNEȘTE GHIDUL PAGINA MODULUI

ÎNAINTE SĂ ÎNCEPI

Primii pași

PAS 01

Instalează și pornește

Configurația generată este deja profilul recomandat.

PAS 02

Păstrează fixurile active

Rotation Fix și Tracker Cleanup sunt modulele automate validate.

PAS 03

Activează debug doar când e nevoie

EntityTracker Diagnostics este un instrument de investigație, nu o cerință.

Server Diagnostics urmează filozofia fail-open și fixuri înguste: cazurile incerte sunt lăsate Hytale în locul unui cleanup generic.

CAPITOL 01 · 1 EXEMPLE

Profil de producție

O configurație curată este deja pregătită pentru utilizare normală.

01PROPERTIES

Profil de producție recomandat

Într-o instalare curată, fixurile validate sunt active, iar instrumentele grele rămân dezactivate.

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

CE FACE

Într-o instalare curată, fixurile validate sunt active, iar instrumentele grele rămân dezactivate.

COMPORTAMENT IMPORTANT

  • dryRun=false înseamnă că cleanupul validat este activ în mod real.
  • Diagnosticul profund nu este necesar pentru cleanup.
  • Profilul normal este proiectat pentru sarcină mică și zgomot redus.

CAPITOL 02 · 1 EXEMPLE

Flying NPC Rotation Fix

Corectează doar valori roll nefinite NaN/Infinity pe modelele zburătoare configurate.

01PROPERTIES

Corecția rotației NPC-urilor zburătoare

Verifică modelele configurate când intră în ECS și repară doar valorile de rotație nefinite.

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

config.properties

CE FACE

Verifică modelele configurate când intră în ECS și repară doar valorile de rotație nefinite.

COMPORTAMENT IMPORTANT

  • Nu modifică AI, pathfinding, viteza, regulile de spawn sau rotațiile valide.
  • Prefixul implicit pentru modelele eligibile rămâne NPC/Flying_.
  • Lasă debug dezactivat dacă nu investighezi un caz specific.

CAPITOL 03 · 1 EXEMPLE

Dropped Item Tracker Cleanup

Elimină doar update-uri deja invalide care pot fi corelate sigur cu dropped item-uri eliminate.

01PROPERTIES

EntityTracker cleanup pentru dropped items

Rulează între coada de update-uri și trimiterea pachetelor, dar numai când o referință invalidă poate fi corelată sigur cu un dropped item deja eliminat.

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

config.properties

CE FACE

Rulează între coada de update-uri și trimiterea pachetelor, dar numai când o referință invalidă poate fi corelată sigur cu un dropped item deja eliminat.

COMPORTAMENT IMPORTANT

  • Nu modifică dropped item-uri vii, ItemStack-uri, cantități, timere pickup/despawn sau update-uri valide.
  • Condițiile neașteptate sunt fail-open, astfel Hytale gestionează cazul normal.
  • Rezumatul la 300 de secunde evită spamul în producție.

CAPITOL 04 · 1 EXEMPLE

Diagnostic profund

Instrumente doar de observare pentru investigații EntityTracker/ECS.

01PROPERTIES

Activează diagnosticul profund doar temporar

La investigarea avertismentelor EntityTracker/ECS poți activa modulul de observare.

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

config.properties

CE FACE

La investigarea avertismentelor EntityTracker/ECS poți activa modulul de observare.

COMPORTAMENT IMPORTANT

  • Poate produce mult mai multă telemetrie locală și fișiere mai mari.
  • Înregistrează context despre arhetipuri ECS, componente, lifecycle, viewers și corelații.
  • După investigație revino la profilul minim.

CAPITOL 05 · 1 EXEMPLE

Loguri și retenție

Un fișier persistent pe categorie, compactat la pornire și shutdown.

01PROPERTIES

Retenție pe categorie

Modul păstrează un fișier pe categorie și elimină înregistrările vechi din același fișier.

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

config.properties

CE FACE

Modul păstrează un fișier pe categorie și elimină înregistrările vechi din același fișier.

COMPORTAMENT IMPORTANT

  • Compactarea are loc la inițializare și shutdown curat.
  • Nu creează fișiere zilnice fără sfârșit doar pentru retenție.
  • Logurile rămân locale și nu sunt încărcate de mod.

Înainte de a folosi un exemplu

Nu sunt necesare comenzi sau permisiuni pentru jucători.

Logurile pot conține context util de debug; verifică-le înainte de publicare.

Contoarele cleanup la zero nu înseamnă neapărat că modul nu funcționează; cazul țintă poate pur și simplu să nu fi apărut.

ÎNAPOI SUS