spark — это профайлер для серверов Minecraft. Если сервер лагает, spark за секунды покажет, проседает ли тикрейт, какие плагины или фермы съедают время и не упираются ли в лимит процессор или память. В этом гайде разобраны три команды, которые тебе действительно нужны, и то, как читать их результаты. Скриншоты сделаны на тестовом сервере с Paper 1.21.4.

Установка

spark работает как плагин на Paper и Spigot и как мод на Fabric, NeoForge и Forge. В панели он находится в разделе Плагины → Браузер. Настройка не требуется. Команды стоит выдавать группе модераторов; соответствующее право называется spark. Как его выдать, описано в гайде LuckPerms: настройка прав.

Первый взгляд: TPS и длительность тика

/spark tps выводит три строки:

Вывод /spark tps: TPS, длительность тиков и загрузка процессора (Enlarge image)
  • TPS (тиков в секунду) за последние 5 секунд, 10 секунд, 1, 5 и 15 минут. Максимум — 20,0. Примерно до 19 игроки ничего не замечают, ниже 15 животные двигаются рывками, а ниже 10 играть на сервере становится невозможно.
  • Длительность тика: минимум, медиана, 95-й процентиль и максимум в миллисекундах. Чтобы удерживать 20 TPS, тик должен укладываться в 50 мс. На скриншоте медиана равна 2,4 мс, то есть запас у сервера большой. Главное здесь — 95-й процентиль: если он близок к 50 мс, появляются фризы, даже когда среднее значение выглядит хорошо.
  • Загрузка процессора отдельно для системы (вся машина) и процесса (только твой сервер). На арендованном сервере важно значение процесса.

/spark healthreport собирает те же показатели, а также данные о памяти и диске в один отчёт.

Профайлер: кто съедает время?

Когда TPS проседает, запусти профайлер:

/spark profiler start

spark подтвердит запуск и продолжит работать в фоне. Дай ему поработать хотя бы минуту, пока проблема проявляется, а затем выполни:

/spark profiler stop
Профайлер работает в фоне; spark показывает команды для просмотра, остановки и отмены (Enlarge image)

При остановке spark загружает отчёт на spark.lucko.me и выдаёт ссылку. В отчёте нет ников игроков, IP-адресов и сообщений из чата — только деревья вызовов Java-процесса. /spark profiler open открывает его прямо во время работы, а /spark profiler cancel отменяет профилирование без загрузки отчёта.

В отчёте раскрывай дерево сверху вниз. Вот что там обычно находится:

  • Тики сущностей определённого типа: ферма с сотнями животных или предметов. Уменьши ферму или снизь нагрузку с помощью entity-activation-range в paper-world-defaults.yml.
  • Плагин в обработчике событий: обнови плагин, проверь его конфигурацию или замени его.
  • Загрузка чанков из-за игроков, которые быстро летают: уменьши дальность прорисовки или заранее сгенерируй мир с помощью Chunky.
  • Редстоун-часы: схема, которая никогда не останавливается. Попроси игрока её отключить.

Сборка мусора и память

/spark gc показывает, как часто и надолго приостанавливается сборщик мусора Java. Много длинных пауз означает нехватку RAM или утечку памяти в одном из плагинов. /spark heapsummary показывает, какие типы объектов занимают память. Прежде чем докупать RAM, стоит заглянуть сюда: часто проблему решает обновление плагина.

Типичные ошибки

  • TPS 20, но всё равно лагает. Проблема на стороне клиента или в сети. /spark ping показывает задержку для каждого игрока.
  • Потерялась ссылка на отчёт профайлера. /spark profiler без аргументов показывает статус; после остановки ссылка также есть в консоли сервера.
  • Показатели не с чем сравнить. Само по себе значение TPS мало о чём говорит. Сделай один замер на пустом сервере, чтобы получить точку отсчёта.

Другие гайды

Если сгенерировать мир заранее, серверу не придётся загружать чанки на ходу: Chunky: предварительная генерация мира. О том, как панель сообщает о постоянно низком TPS, читай в гайде «Лаги сервера Minecraft: TPS и Watchdog».

Источники