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.
  • Нескінченні щоденні файли лише заради retention не створюються.
  • Журнали лишаються локальними й не завантажуються модом.

Перед використанням прикладу

Команди та дозволи гравців не потрібні.

Журнали можуть містити корисний debug-контекст; перевіряйте їх перед публікацією.

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

НАГОРУ