spark — это профайлер для серверов Minecraft. Если сервер лагает, spark за секунды покажет, проседает ли тикрейт, какие плагины или фермы съедают время и не упираются ли в лимит процессор или память. В этом гайде разобраны три команды, которые тебе действительно нужны, и то, как читать их результаты. Скриншоты сделаны на тестовом сервере с Paper 1.21.4.
Установка
spark работает как плагин на Paper и Spigot и как мод на Fabric, NeoForge и Forge. В панели он находится в разделе Плагины → Браузер. Настройка не требуется. Команды стоит выдавать группе модераторов; соответствующее право называется spark. Как его выдать, описано в гайде LuckPerms: настройка прав.
Первый взгляд: TPS и длительность тика
/spark 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
(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».
Источники
- Документация spark: https://spark.lucko.me/docs/
- Команды: https://spark.lucko.me/docs/Command-Usage
- Как читать отчёты профайлера: https://spark.lucko.me/docs/guides/Finding-lag-spikes