skTrace (Эскейтрейс)

Плагин для серверов Майнкрафт, который ищет причины лагов в Skript. Он измеряет нагрузку от триггеров, функций, событий, циклов и записи переменных, а затем создаёт интерактивный отчёт для браузера.

Возможности

• Показывает для каждого триггера число вызовов, общее, среднее и максимальное время работы.
• Отдельно учитывает время функций, определяет нагрузку по файлам скриптов и показывает самые тяжёлые тики.
• Строит график тиков относительно лимита в 50 мс: можно выделить отрезок графика и посмотреть данные только за это время.
• Считает создание, изменение и удаление глобальных переменных, отображает наиболее часто записываемые переменные и отмечает сохранения variables.csv на графике.
• Команда просмотра циклов показывает активные циклы и число их итераций. При зависшем цикле без задержки в консоль выводится строка скрипта, вызвавшая зависание.
• По желанию включает непрерывный сбор данных в кольцевой буфер: снимок последних секунд можно сохранить уже после всплеска нагрузки.
• Экспериментальная функция построчного профилирования выделяет в просмотрщике исходника конкретные тяжёлые инструкции. Она выключена по умолчанию.

Команды

• /sktrace start — начать сбор данных.
• /sktrace stop — завершить сбор.
• /sktrace status — показать в чате самые тяжёлые триггеры.
• /sktrace report — создать отчёт и получить ссылку на него.
• /sktrace clip — сохранить в отчёт последние данные из кольцевого буфера.
• /sktrace loops — показать работающие циклы.
• /sktrace rolling on|off — включить или выключить кольцевой буфер.
• /sktrace reset — очистить собранную статистику.

Доступен короткий вариант команды: /skt.

У report и clip есть параметры: --no-upload оставляет отчёт только локально, --include-files добавляет исходники скриптов, --variable-values показывает значения, обработанные при сохранении, а --show-secrets раскрывает скрытые значения опций.

Права

• sktrace.use — доступ к командам плагина; по умолчанию есть у оператора.

Настройка

Отчёты сначала сохраняются в plugins/Sktrace/reports/. Чтобы не отправлять их на сервис коротких ссылок, укажите пустое значение для upload-endpoint или используйте --no-upload. Значения опций в отчётах скрываются, пока не указан параметр --show-secrets.

Требования

Нужен сервер Paper или Spigot, Skript и Java 21. Плагин работает вместе со spark: spark анализирует JVM, а этот плагин — Skript.