HyTari Studios · Официальное руководство по настройке

Server Diagnostics

Точечные исправления всегда активны, тяжелая диагностика — только при необходимости.

Server Diagnostics исправляет конкретные проверенные случаи, не превращаясь в общий cleanup. Рекомендуемый профиль рабочий и тихий: автоматические исправления ON, глубокая диагностика OFF.

НАЧАТЬ РУКОВОДСТВО СТРАНИЦА МОДА

ПЕРЕД НАЧАЛОМ

Начало работы

ШАГ 01

Установите и запустите

Сгенерированная конфигурация уже является рекомендуемым профилем.

ШАГ 02

Оставьте исправления включенными

Rotation Fix и Tracker Cleanup — проверенные автоматические модули.

ШАГ 03

Включайте debug только при необходимости

EntityTracker Diagnostics — инструмент расследования, а не обязательное требование.

Server Diagnostics придерживается fail-open и узких исправлений: сомнительные случаи оставляются Hytale вместо общего cleanup.

ГЛАВА 01 · 1 ПРИМЕРЫ

Профиль production

Чистая конфигурация уже готова к обычной работе.

01PROPERTIES

Рекомендуемый production-профиль

В чистой установке проверенные исправления активны, а тяжелые инструменты выключены.

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

ЧТО ЭТО ДЕЛАЕТ

В чистой установке проверенные исправления активны, а тяжелые инструменты выключены.

ВАЖНОЕ ПОВЕДЕНИЕ

  • dryRun=false означает, что проверенный cleanup действительно активен.
  • Глубокая диагностика не нужна для работы cleanup.
  • Обычный профиль рассчитан на низкую нагрузку и минимум шума.

ГЛАВА 02 · 1 ПРИМЕРЫ

Flying NPC Rotation Fix

Исправляет только нечисловые NaN/Infinity roll-значения у настроенных летающих моделей.

01PROPERTIES

Исправление вращения летающих NPC

Проверяет настроенные модели при входе в ECS и исправляет только нечисловые значения вращения.

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

config.properties

ЧТО ЭТО ДЕЛАЕТ

Проверяет настроенные модели при входе в ECS и исправляет только нечисловые значения вращения.

ВАЖНОЕ ПОВЕДЕНИЕ

  • Не меняет AI, pathfinding, скорость, правила спавна и корректные вращения.
  • Префикс подходящих моделей по умолчанию остается NPC/Flying_.
  • Держите debug выключенным, если не расследуете конкретный случай.

ГЛАВА 03 · 1 ПРИМЕРЫ

Dropped Item Tracker Cleanup

Удаляет только уже недействительные updates, которые безопасно связываются с удаленными dropped item.

01PROPERTIES

EntityTracker cleanup для dropped item

Работает между очередью update и отправкой пакетов, только если недействительную ссылку можно безопасно связать с уже удаленным dropped item.

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

config.properties

ЧТО ЭТО ДЕЛАЕТ

Работает между очередью update и отправкой пакетов, только если недействительную ссылку можно безопасно связать с уже удаленным dropped item.

ВАЖНОЕ ПОВЕДЕНИЕ

  • Не меняет живые dropped item, ItemStack, количества, pickup/despawn-таймеры и корректные updates.
  • Неожиданные условия fail-open, поэтому Hytale обрабатывает случай штатно.
  • Интервал сводки 300 секунд предотвращает spam в production.

ГЛАВА 04 · 1 ПРИМЕРЫ

Глубокая диагностика

Наблюдательные инструменты для расследований EntityTracker/ECS.

01PROPERTIES

Включайте глубокую диагностику временно

При расследовании EntityTracker/ECS можно активировать наблюдательный модуль.

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

config.properties

ЧТО ЭТО ДЕЛАЕТ

При расследовании EntityTracker/ECS можно активировать наблюдательный модуль.

ВАЖНОЕ ПОВЕДЕНИЕ

  • Он может создавать гораздо больше локальной телеметрии и крупные файлы.
  • Записывает контекст ECS-архетипов, компонентов, lifecycle, viewers и корреляций.
  • После расследования вернитесь к минимальному профилю.

ГЛАВА 05 · 1 ПРИМЕРЫ

Журналы и хранение

Один постоянный файл на категорию, сжимаемый при старте и shutdown.

01PROPERTIES

Хранение по категориям

Мод держит один файл на категорию и удаляет старые записи из него же.

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

config.properties

ЧТО ЭТО ДЕЛАЕТ

Мод держит один файл на категорию и удаляет старые записи из него же.

ВАЖНОЕ ПОВЕДЕНИЕ

  • Компактизация выполняется при инициализации и чистом shutdown.
  • Не создаются бесконечные ежедневные файлы только ради хранения.
  • Журналы остаются локальными и не загружаются модом.

Перед использованием примера

Команды и права игроков не требуются.

Журналы могут содержать полезный debug-контекст; проверяйте их перед публикацией.

Нулевые счетчики cleanup не обязательно означают проблему — целевой случай мог просто не возникнуть.

НАВЕРХ