HyTari Studios · Guida ufficiale alla configurazione

Server Diagnostics

Fix mirati sempre attivi, diagnostica pesante solo quando serve.

Server Diagnostics nasce per correggere casi specifici e già validati senza trasformarsi in un generico sistema di pulizia. Il profilo consigliato è operativo e silenzioso: fix automatici ON, diagnostica profonda OFF.

INIZIA LA GUIDA PAGINA MOD

PRIMA DI INIZIARE

Per iniziare

PASSO 01

Installa e avvia

La configurazione generata è già il profilo consigliato.

PASSO 02

Lascia attivi i fix

Rotation Fix e Tracker Cleanup sono i moduli automatici validati.

PASSO 03

Abilita debug solo se serve

EntityTracker Diagnostics è uno strumento di indagine, non un requisito.

Server Diagnostics usa una filosofia fail-open e fix stretti: i casi incerti vengono lasciati a Hytale invece di applicare correzioni generiche.

CAPITOLO 01 · 1 ESEMPI

Profilo produzione

La configurazione pulita è già pronta per l'uso normale.

01PROPERTIES

Profilo consigliato

Su una nuova installazione i fix validati sono attivi e i tool costosi restano spenti.

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

COSA FA

Su una nuova installazione i fix validati sono attivi e i tool costosi restano spenti.

COMPORTAMENTO IMPORTANTE

  • dryRun=false significa che il cleanup validato è realmente attivo.
  • La diagnostica profonda non è necessaria per il funzionamento del cleanup.
  • Il profilo normale è progettato per essere silenzioso e leggero.

CAPITOLO 02 · 1 ESEMPI

Flying NPC Rotation Fix

Ripara soltanto roll non finiti NaN/Infinity su modelli volanti configurati.

01PROPERTIES

Correzione rotazione NPC volanti

Controlla i modelli configurati quando entrano nell'ECS e corregge soltanto valori di rotazione non finiti.

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

config.properties

COSA FA

Controlla i modelli configurati quando entrano nell'ECS e corregge soltanto valori di rotazione non finiti.

COMPORTAMENTO IMPORTANTE

  • Non cambia AI, pathfinding, velocità, spawn rules o rotazioni valide.
  • Il modello eleggibile di default resta NPC/Flying_.
  • Il debug va lasciato off se non stai investigando un caso specifico.

CAPITOLO 03 · 1 ESEMPI

Dropped Item Tracker Cleanup

Rimuove solo update già invalidi correlabili a dropped item rimossi.

01PROPERTIES

Cleanup EntityTracker per dropped item

Interviene tra la coda degli update e l'invio packet, ma solo quando un riferimento invalido può essere correlato in sicurezza a un dropped item già rimosso.

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

config.properties

COSA FA

Interviene tra la coda degli update e l'invio packet, ma solo quando un riferimento invalido può essere correlato in sicurezza a un dropped item già rimosso.

COMPORTAMENTO IMPORTANTE

  • Non modifica dropped item vivi, ItemStack, quantità, pickup/despawn timer o update validi.
  • Le condizioni inattese sono fail-open: Hytale gestisce normalmente il caso.
  • Il riepilogo ogni 300 secondi evita spam in produzione.

CAPITOLO 04 · 1 ESEMPI

Diagnostica profonda

Strumenti observation-only per indagini EntityTracker/ECS.

01PROPERTIES

Attivare la diagnostica solo temporaneamente

Quando serve investigare warning EntityTracker/ECS puoi abilitare il modulo observation-only.

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

config.properties

COSA FA

Quando serve investigare warning EntityTracker/ECS puoi abilitare il modulo observation-only.

COMPORTAMENTO IMPORTANTE

  • Può produrre molta più telemetria locale e file più grandi.
  • Raccoglie contesto su archetipi ECS, componenti, lifecycle, viewer e correlazioni.
  • Dopo l'indagine conviene tornare al profilo minimo.

CAPITOLO 05 · 1 ESEMPI

Log e retention

Un file persistente per categoria, compattato a startup e shutdown.

01PROPERTIES

Retention per categoria

La mod mantiene un solo file per categoria e rimuove i record vecchi dallo stesso file.

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

config.properties

COSA FA

La mod mantiene un solo file per categoria e rimuove i record vecchi dallo stesso file.

COMPORTAMENTO IMPORTANTE

  • La compattazione avviene durante inizializzazione e shutdown pulito.
  • Non vengono creati infiniti file giornalieri solo per implementare la retention.
  • I log restano locali al server e non vengono caricati dalla mod.

Prima di usare un esempio

Nessun comando giocatore o permesso è richiesto.

I log possono contenere contesto utile al debug: rivedili prima di pubblicarli.

Se i contatori cleanup restano a zero non significa necessariamente che la mod non funzioni: può semplicemente non essersi verificato il caso target.

TORNA SU