Minecraft eklentisi BKCommonLib

🔌 BKCommonLib hakkında

BKCommonLib, Minecraft sunucuları için sunucu taraflı bir kütüphane ve eklentidir; düşük seviyeli yardımcı araçları, reflection yardımcılarını, çalışma anında yeniden eşlemeyi ve küçük framework'leri tek yerde toplar, böylece diğer eklentilerin NMS'yi (Minecraft sunucu iç yapıları) doğrudan kullanması gerekmez. Minecraft veya sunucu fork'ları iç yapıları değiştirdiğinde BKCommonLib güncellenir; bu yüzden bağımlı eklentilerin çoğu zaman kendilerinin değişmesine gerek kalmaz.

🎯 Amaç

Eklenti geliştiricileri ve sunucu yöneticileri için kararlı, yeniden kullanılabilir bir uyumluluk ve araç katmanı sağlamak. BKCommonLib, eklenti yazarlarının dağıtmak zorunda olduğu sürüme özel kod miktarını azaltır ve paket işleme, dönüşümler, komut framework'leri ve diğer düşük seviyeli işlemler için daha üst seviye API'ler sunar.

⚙️ Özellikler

• Mountiplex reflection/template sistemiyle çalışma anında sınıf üretimi ve yeniden eşleme.
• Yerleşik komut framework araçları (Cloud Command Framework entegrasyonu).
• Yaşam döngüsü yardımcıları, bağımlılık kontrolleri ve dinleyici ile komut kaydı için kullanışlı API'ler içeren eklenti temel framework'ü.
• Tip dönüştürme araçları (gerektiğinde Bukkit tipleri ile dahili tipler arasında otomatik dönüşümler).
• Birçok sunucu fork'u ve sürümü için araçlar ve uyumluluk katmanları, böylece eklentiler doğrudan NMS kullanımından kaçınır.

🧩 Kimler için

• Çok sürümlü bir uyumluluk katmanı ve reflection araçları isteyen eklenti geliştiricileri.
• Ortak bir uyumluluk kütüphanesine dayanan çok sayıda üçüncü taraf eklentinin bulunduğu ağları yöneten sunucu yöneticileri.
• Paper/Spigot fork'ları arasında tutarlı davranışa ihtiyaç duyan teknik sunucu operatörleri.

🏗️ Örnek kullanım alanları

• Bir eklenti, Minecraft sürümleri arasındaki paket farklarını BKCommonLib ile yönetir; böylece eklentinin jar dosyası güncellemeler arasında değişmeden kalabilir.
• Bir geliştirici, ekli komut framework araçlarını kullanarak öneri desteği ve izin yönetimi olan anotasyonlu komutlar uygular.
• Bir sunucu, Minecraft sürümünden hemen sonra güncelleme yapma sıklığını azaltmak için BKCommonLib'e bağlı eklentiler çalıştırır.

⚙️ Kurulum

📥 Kurulum adımları

• Resmi BKCommonLib jar dosyasını eklentinin resmi dağıtımından indirin (sağlanan jar dosyasını sunucunuzun plugins/ klasörüne koyun).
• Eklenti başlangıçta yüklensin diye sunucuyu yeniden başlatın.
• Doğru şekilde başlatıldığını doğrulamak için sunucu konsolu çıktısında BKCommonLib başlangıç mesajlarını kontrol edin.

📦 Bağımlılıklar

• BKCommonLib bir kütüphane eklentisi olarak dağıtılır; çekirdek kütüphanenin kendisi için ek Bukkit/Spigot eklenti bağımlılıkları gerekmez.

🧠 Teknik notlar

• Doğrulanmış uyumlu sunucu yazılımları arasında Spigot ve Paper fork'ları bulunur (proje açıkça Spigot, PaperMC, Purpur ve diğer yaygın fork'ları listeler).
• Proje, en yeni BKCommonLib sürümü kullanıldığında Minecraft 1.8 ve üzeri sürümlerle uyumluluk belirtir.
• BKCommonLib MIT Lisansı altında yayınlanır.
• Yazarın belirttiğine göre proje, üçüncü taraf kütüphaneleri (örneğin Cloud Command Framework, ASM, Javassist, Objenesis, SnakeYAML ve Gson) paketler/gölgeler.

🤝 Bu eklenti ne zaman kullanışlıdır

Birden fazla eklentinin her birinin NMS'yi ele almasına gerek kalmadan düşük seviyeli sunucu özelliklerine tutarlı erişim istediği eklentileri yönetiyorsanız veya böyle bir sunucu çalıştırıyorsanız, BKCommonLib paylaşılan bir uyumluluk katmanı ve geliştirme araçları sunar; bu da eklenti başına sürüme özel kodu ve bakım yükünü azaltır.