HyTari Studios · Guia oficial de configuração

Server Diagnostics

Correções específicas sempre ativas, diagnóstico pesado apenas quando necessário.

O Server Diagnostics corrige casos específicos e validados sem virar um sistema de limpeza genérico. O perfil recomendado é operacional e silencioso: correções automáticas ON, diagnóstico profundo OFF.

INICIAR O GUIA PÁGINA DO MOD

ANTES DE COMEÇAR

Primeiros passos

ETAPA 01

Instale e inicie

A configuração gerada já é o perfil recomendado.

ETAPA 02

Mantenha as correções ativas

Rotation Fix e Tracker Cleanup são os módulos automáticos validados.

ETAPA 03

Ative debug só quando necessário

EntityTracker Diagnostics é uma ferramenta de investigação, não um requisito.

O Server Diagnostics segue uma filosofia fail-open com correções estreitas: casos incertos são deixados para o Hytale em vez de receberem limpeza genérica.

CAPÍTULO 01 · 1 EXEMPLOS

Perfil de produção

Uma configuração limpa já está pronta para uso normal.

01PROPERTIES

Perfil de produção recomendado

Em uma instalação limpa, as correções validadas ficam ativas enquanto ferramentas pesadas permanecem desativadas.

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

O QUE FAZ

Em uma instalação limpa, as correções validadas ficam ativas enquanto ferramentas pesadas permanecem desativadas.

COMPORTAMENTO IMPORTANTE

  • dryRun=false significa que o cleanup validado está realmente ativo.
  • O diagnóstico profundo não é necessário para o cleanup funcionar.
  • O perfil normal foi projetado para ser silencioso e leve.

CAPÍTULO 02 · 1 EXEMPLOS

Flying NPC Rotation Fix

Repara apenas valores de roll não finitos NaN/Infinity em modelos voadores configurados.

01PROPERTIES

Correção de rotação de NPCs voadores

Verifica modelos configurados ao entrarem no ECS e repara apenas valores de rotação não finitos.

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

config.properties

O QUE FAZ

Verifica modelos configurados ao entrarem no ECS e repara apenas valores de rotação não finitos.

COMPORTAMENTO IMPORTANTE

  • Não altera IA, pathfinding, velocidade, regras de spawn ou rotações válidas.
  • O prefixo de modelo elegível padrão continua NPC/Flying_.
  • Mantenha debug desligado a menos que esteja investigando um caso específico.

CAPÍTULO 03 · 1 EXEMPLOS

Dropped Item Tracker Cleanup

Remove apenas updates já inválidos que podem ser correlacionados com segurança a dropped items removidos.

01PROPERTIES

Cleanup EntityTracker para dropped items

Executa entre a fila de updates e o envio de pacotes, mas apenas quando uma referência inválida pode ser correlacionada com segurança a um dropped item já removido.

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

config.properties

O QUE FAZ

Executa entre a fila de updates e o envio de pacotes, mas apenas quando uma referência inválida pode ser correlacionada com segurança a um dropped item já removido.

COMPORTAMENTO IMPORTANTE

  • Não modifica dropped items vivos, ItemStacks, quantidades, temporizadores de pickup/despawn ou updates válidos.
  • Condições inesperadas são fail-open para que o Hytale trate o caso normalmente.
  • O intervalo de resumo de 300 segundos evita spam em produção.

CAPÍTULO 04 · 1 EXEMPLOS

Diagnóstico profundo

Ferramentas somente de observação para investigações EntityTracker/ECS.

01PROPERTIES

Ative diagnóstico profundo apenas temporariamente

Ao investigar avisos EntityTracker/ECS, você pode ativar o módulo somente de observação.

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

config.properties

O QUE FAZ

Ao investigar avisos EntityTracker/ECS, você pode ativar o módulo somente de observação.

COMPORTAMENTO IMPORTANTE

  • Ele pode gerar muito mais telemetria local e arquivos maiores.
  • Registra contexto sobre arquétipos ECS, componentes, ciclo de vida, viewers e correlações.
  • Depois da investigação, volte ao perfil mínimo.

CAPÍTULO 05 · 1 EXEMPLOS

Logs e retenção

Um arquivo persistente por categoria, compactado na inicialização e no desligamento.

01PROPERTIES

Retenção por categoria

O mod mantém um arquivo por categoria e remove registros antigos do mesmo arquivo.

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

config.properties

O QUE FAZ

O mod mantém um arquivo por categoria e remove registros antigos do mesmo arquivo.

COMPORTAMENTO IMPORTANTE

  • A compactação ocorre na inicialização e no desligamento limpo.
  • Não cria infinitos arquivos diários apenas para implementar retenção.
  • Os logs ficam locais no servidor e não são enviados pelo mod.

Antes de usar um exemplo

Nenhum comando ou permissão de jogador é necessário.

Os logs podem conter contexto útil de depuração; revise antes de publicar.

Contadores de cleanup em zero não significam necessariamente que o mod não funciona; o caso-alvo pode simplesmente não ter ocorrido.

VOLTAR AO TOPO