Плагін Minecraft spark

🔌 Про spark

spark — це профайлер продуктивності для серверів Minecraft, клієнтів і proxy-програм. Він надає інструменти для перевірки активності CPU, збирання базових знімків пам’яті та heap dump, а також звітування про показники стану сервера (TPS, тривалість tick, використання CPU/пам’яті/диска). Проєкт має відкритий код і створений для отримання читабельного виводу профілювання з мінімальними налаштуваннями.

🎯 Призначення

Основна мета spark — допомогти адміністраторам серверів і розробникам діагностувати причини низької продуктивності (лаги, низький tick rate, високе використання CPU, надмірне утримання пам’яті) шляхом створення вибіркових CPU-профілів, зведень по пам’яті, heap dump і безперервних показників стану.

⚙️ Можливості

• Профілювання CPU (statistical sampling) з двома рушіями: рушієм на основі Java ThreadMXBean і необов’язковим native/async-profiler рушієм (native-рушій доступний на Linux і macOS).
• Перевірка пам’яті, включно зі зведеннями heap і можливістю створювати повні HPROF heap dump для зовнішнього аналізу.
• Звітування про стан сервера: вимірювання TPS, статистика тривалості tick, використання CPU і пам’яті, а також моніторинг використання диска.
• Читабельний вивід профілю, призначений для перегляду у viewer-компоненті проєкту.
• Легка архітектура, розрахована на використання на продакшн-серверах із мінімальною конфігурацією.

🧩 Для кого це

• Адміністратори та оператори серверів, які вирішують проблеми продуктивності в мережах Survival, SMP, minigame або з proxy-інфраструктурою.
• Розробники плагінів і модів, яким потрібні точні дані профілювання для шляхів виконання коду та використання пам’яті.
• Оператори, що запускають Fabric/Forge/Spigot/Paper/Proxy-налаштування і потребують глибшої діагностики, ніж прості показники TPS.

🏗️ Приклади використання

• Зняти короткий CPU-профіль, щоб визначити, який плагін, мод або завдання сервера найбільше використовує CPU під час лаг-спайків.
• Зробити зведення heap або heap dump, щоб перевірити надмірну кількість instance або витоки пам’яті.
• Безперервно відстежувати TPS і тривалість tick, щоб співвіднести погіршення продуктивності з подіями на сервері або зовнішнім навантаженням.

⚙️ Встановлення

📥 Налаштування

• Завантажте відповідний jar плагіна/мода для вашої платформи.
• Помістіть jar у папку plugins/ сервера (або mods/plugins) для цільової платформи.
• Перезапустіть сервер і переконайтеся, що плагін/мод завантажився, перевіривши консоль/логи сервера.

(Це стандартні кроки встановлення для плагінів Bukkit/Spigot/Paper та інших підтримуваних платформ.)

🧠 Технічні примітки

• Проєкт надає компоненти для різних платформ (Bukkit/Paper, Fabric, Forge, збірки proxy тощо).
• Native-рушій async-profiler доступний лише на Linux і macOS; Java-версія профайлера працює на будь-якому JVM, але використовує інший метод sampling.
• spark може створювати HPROF heap dump для зовнішнього аналізу за допомогою стандартних JVM-інструментів.
• Проєкт випущено під ліцензією GNU GPLv3.

🤝 Коли цей плагін корисний

Якщо вам потрібне конкретне, засноване на вибірці профілювання та перевірка пам’яті, щоб знайти першопричину лагів або проблем із пам’яттю на сервері чи proxy Minecraft, spark надає профілювання, аналіз heap і показники стану, необхідні для прийняття обґрунтованих рішень щодо налагодження й оптимізації.