HyTari Studios · Officiële configuratiehandleiding

Server Diagnostics

Gerichte fixes altijd actief, zware diagnostiek alleen wanneer nodig.

Server Diagnostics corrigeert specifieke, gevalideerde gevallen zonder een generiek opschoonsysteem te worden. Het aanbevolen profiel is actief en stil: automatische fixes ON, diepe diagnostiek OFF.

START DE HANDLEIDING MODPAGINA

VOORDAT JE BEGINT

Aan de slag

STAP 01

Installeer en start

De gegenereerde configuratie is al het aanbevolen profiel.

STAP 02

Laat de fixes aan

Rotation Fix en Tracker Cleanup zijn de gevalideerde automatische modules.

STAP 03

Debug alleen wanneer nodig

EntityTracker Diagnostics is een onderzoekstool, geen vereiste.

Server Diagnostics volgt een fail-open-filosofie met smalle fixes: onzekere gevallen worden aan Hytale overgelaten in plaats van generiek opgeschoond.

HOOFDSTUK 01 · 1 VOORBEELDEN

Productieprofiel

Een schone configuratie is direct klaar voor normaal gebruik.

01PROPERTIES

Aanbevolen productieprofiel

Bij een schone installatie zijn gevalideerde fixes actief terwijl zware tools uit blijven.

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

WAT HET DOET

Bij een schone installatie zijn gevalideerde fixes actief terwijl zware tools uit blijven.

BELANGRIJK GEDRAG

  • dryRun=false betekent dat de gevalideerde cleanup echt actief is.
  • Diepe diagnostiek is niet nodig voor de cleanup.
  • Het normale profiel is stil en licht ontworpen.

HOOFDSTUK 02 · 1 VOORBEELDEN

Flying NPC Rotation Fix

Herstelt alleen niet-eindige NaN/Infinity-rollwaarden op geconfigureerde vliegende modellen.

01PROPERTIES

Rotatiecorrectie voor vliegende NPC's

Controleert geconfigureerde modellen bij binnenkomst in ECS en herstelt alleen niet-eindige rotatiewaarden.

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

config.properties

WAT HET DOET

Controleert geconfigureerde modellen bij binnenkomst in ECS en herstelt alleen niet-eindige rotatiewaarden.

BELANGRIJK GEDRAG

  • Wijzigt geen AI, pathfinding, snelheid, spawnregels of geldige rotaties.
  • De standaardprefix voor geschikte modellen blijft NPC/Flying_.
  • Laat debug uit tenzij je een specifiek geval onderzoekt.

HOOFDSTUK 03 · 1 VOORBEELDEN

Dropped Item Tracker Cleanup

Verwijdert alleen reeds ongeldige updates die veilig aan verwijderde dropped items kunnen worden gekoppeld.

01PROPERTIES

EntityTracker-cleanup voor dropped items

Draait tussen het in de wachtrij zetten van updates en pakketverzending, alleen als een ongeldige referentie veilig aan een al verwijderd dropped item kan worden gekoppeld.

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

config.properties

WAT HET DOET

Draait tussen het in de wachtrij zetten van updates en pakketverzending, alleen als een ongeldige referentie veilig aan een al verwijderd dropped item kan worden gekoppeld.

BELANGRIJK GEDRAG

  • Wijzigt geen levende dropped items, ItemStacks, aantallen, pickup/despawn-timers of geldige updates.
  • Onverwachte omstandigheden zijn fail-open zodat Hytale het geval normaal afhandelt.
  • Het samenvattingsinterval van 300 seconden voorkomt productiespam.

HOOFDSTUK 04 · 1 VOORBEELDEN

Diepe diagnostiek

Alleen-observatiehulpmiddelen voor EntityTracker/ECS-onderzoek.

01PROPERTIES

Diepe diagnostiek alleen tijdelijk inschakelen

Voor onderzoek naar EntityTracker/ECS-waarschuwingen kun je de observatiemodule activeren.

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

config.properties

WAT HET DOET

Voor onderzoek naar EntityTracker/ECS-waarschuwingen kun je de observatiemodule activeren.

BELANGRIJK GEDRAG

  • Kan veel meer lokale telemetrie en grotere bestanden produceren.
  • Registreert context over ECS-archetypen, componenten, lifecycle, viewers en correlaties.
  • Ga na het onderzoek terug naar het minimale profiel.

HOOFDSTUK 05 · 1 VOORBEELDEN

Logs en retentie

Eén blijvend bestand per categorie, gecompacteerd bij start en shutdown.

01PROPERTIES

Retentie per categorie

De mod gebruikt één bestand per categorie en verwijdert oude records uit datzelfde bestand.

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

config.properties

WAT HET DOET

De mod gebruikt één bestand per categorie en verwijdert oude records uit datzelfde bestand.

BELANGRIJK GEDRAG

  • Compactie gebeurt tijdens initialisatie en nette shutdown.
  • Er worden niet eindeloos dagbestanden aangemaakt alleen voor retentie.
  • Logs blijven lokaal op de server en worden niet door de mod geüpload.

Voordat je een voorbeeld gebruikt

Er zijn geen spelerscommando's of rechten vereist.

Logs kunnen nuttige debugcontext bevatten; controleer ze vóór publicatie.

Cleanup-tellers op nul betekenen niet per se dat de mod niet werkt; het doelgeval kan simpelweg niet zijn opgetreden.

NAAR BOVEN