Minecraft eklentisi spark

🔌 spark hakkında

spark, Minecraft sunucuları, istemcileri ve proxy yazılımları için bir performans profilleyicisidir. CPU etkinliğini incelemek, temel bellek anlık görüntüleri ve heap dump'lar almak ve sunucu sağlık metriklerini raporlamak için araçlar sağlar (TPS, tick süreleri, CPU/bellek/disk kullanımı). Proje açık kaynaklıdır ve minimum kurulumla okunabilir profiling çıktısı üretmek için tasarlanmıştır.

🎯 Amaç

spark'ın temel amacı, örneklemeye dayalı CPU profilleri, bellek özetleri, heap dump'lar ve sürekli sağlık metrikleri üreterek kötü performansın nedenlerini (lag, düşük tick hızı, yüksek CPU kullanımı, aşırı bellek tutulması) sunucu yöneticilerinin ve geliştiricilerin teşhis etmesine yardımcı olmaktır.

⚙️ Özellikler

• İki motorla CPU profilleme (istatistiksel örnekleme): Java ThreadMXBean tabanlı bir motor ve isteğe bağlı native/async-profiler motoru (native motor Linux ve macOS'ta kullanılabilir).
• Heap özetleri ve harici analiz için tam HPROF heap dump oluşturma yeteneği dahil bellek inceleme.
• Sunucu sağlık raporlaması: TPS ölçümleri, tick süresi istatistikleri, CPU ve bellek kullanımı ve disk kullanımı izleme.
• Projenin viewer bileşeninde görüntülenmek üzere tasarlanmış okunabilir profil çıktısı.
• Minimum yapılandırmayla üretim sunucularında kullanılabilecek hafif tasarım.

🧩 Kimler İçin

• Survival, SMP, minigame veya proxy destekli ağlarda performans sorunlarını gideren sunucu yöneticileri ve operatörleri.
• Kod yolları ve bellek kullanımı için hassas profiling verilerine ihtiyaç duyan plugin ve mod geliştiricileri.
• Basit TPS okumalarından daha derin teşhis gerektiren Fabric/Forge/Spigot/Paper/Proxy kurulumlarını çalıştıran operatörler.

🏗️ Örnek Kullanım Senaryoları

• Lag sıçramaları sırasında hangi plugin, mod veya sunucu görevinin en fazla CPU kullandığını belirlemek için kısa bir CPU profili yakalayın.
• Aşırı instance sayıları veya bellek sızıntılarını incelemek için bir heap özeti veya heap dump alın.
• Performans gerilemelerini sunucu olayları veya dış yük ile ilişkilendirmek için TPS ve tick sürelerini sürekli izleyin.

⚙️ Kurulum

📥 Kurulum

• Platformunuz için uygun plugin/mod jar dosyasını indirin.
• Jar dosyasını hedef platform için sunucunun plugins/ (veya mods/plugins) klasörüne yerleştirin.
• Sunucuyu yeniden başlatın ve sunucu konsolu/günlüklerini kontrol ederek plugin/mod'un yüklendiğini doğrulayın.

(Bunlar, Bukkit/Spigot/Paper benzeri plugin'ler ve diğer desteklenen platformlar için standart kurulum adımlarıdır.)

🧠 Teknik Notlar

• Proje platforma özel bileşenler sağlar (Bukkit/Paper, Fabric, Forge, proxy derlemeleri vb.).
• Native async-profiler motoru yalnızca Linux ve macOS'ta kullanılabilir; Java tabanlı profiler herhangi bir JVM'de çalışır ancak farklı bir örnekleme yöntemi kullanır.
• spark, standart JVM araçlarıyla harici analiz için HPROF heap dump'lar üretebilir.
• Proje GNU GPLv3 lisansı altında yayımlanmıştır.

🤝 Bu Plugin Ne Zaman Faydalıdır

Bir Minecraft sunucusunda veya proxy'sinde lag ya da bellek sorunlarının kök nedenini bulmak için somut, örneklemeye dayalı profiling ve bellek incelemesine ihtiyacınız varsa, spark bilinçli hata ayıklama ve ayarlama kararları vermek için gereken profiling, heap incelemesi ve sağlık metriklerini sağlar.