Minecraft eklentisi NBTAPI

🔌 NBT-API hakkında

NBT-API (Item-NBT-API), geliştiricilerin NMS kullanmadan öğelere, varlıklara ve tile entities’e NBT etiketleri okumasına, yazmasına ve eklemesine olanak tanıyan bir Minecraft eklenti kütüphanesidir. Proje, farklı sunucu sürümlerinde NBT ile çalışmak için kararlı bir sarmalayıcı sunar ve NBT verilerini serileştirmek ve kalıcı hale getirmek için yardımcı araçlar sağlar.

🎯 Amaç

Named Binary Tag (NBT) verilerini işlemek için geliştirici odaklı bir API sunarak, eklenti yazarlarının sunucu iç yapılarına doğrudan bağlı kalmadan meta verileri, özel eşya verilerini, varlık etiketlerini veya tile entities verilerini saklayabilmesini sağlamak.

⚙️ Özellikler

• Öğeler, varlıklar ve tile entities için NBT okuma ve yazma.
• İç içe NBT compound’ları ve temel etiket türleri oluşturma ve değiştirme.
• NBT’yi metin olarak veya diğer kapsayıcılarda saklamak için yardımcı araçlar.
• NBT’yi dosyalara veya YAML/JSON/SQL/Redis içinde saklamak üzere dizelere serileştirme desteği.
• Sunucu sürümü değişiklikleri boyunca kararlı bir soyutlama katmanı sağlamayı hedefler.

🧩 Kimler için

• NMS yazmadan güvenilir NBT erişimine ihtiyaç duyan eklenti geliştiricileri.
• Eklentiler tarafından yönetilen özel eşya meta verileri veya kalıcı varlık/tile entities verileri gerektiren sunucular.

🏗️ Örnek kullanım alanları

• Kayıtlar arasında kalıcı olan bir eşya yığınına özel meta veri eklemek.
• Sunucu kodunu değiştirmeden varlıklarda ek özellikler (örneğin özel kimlikler) saklamak.
• Daha sonra geri yüklemek için eşya veya blok NBT’sini bir veritabanına ya da yapılandırma dosyasına serileştirmek.

⚙️ Kurulum

📥 Kurulum

• Resmi eklenti JAR dosyasını indirin ve/veya API’yi build sisteminize bir bağımlılık olarak ekleyin.
• Eklenti JAR dosyasını sunucunun plugins/ dizinine yerleştirin (eğer eklenti sürümünü kullanıyorsanız) veya API’yi eklentiniz için compile/runtime bağımlılığı olarak ekleyin.
• Sunucuyu yeniden başlatın ve kütüphane/eklenti doğru şekilde yüklendi mi diye sunucu konsolunu kontrol edin.

🧠 Teknik notlar

• Proje GitHub üzerinde yayınlanır ve bakımını sürdürülür, MIT lisansı ile dağıtılır.
• Resmi kaynaklar Bukkit/Spigot/Paper sunucu ortamları için destek belirtir.
• Kütüphane, eklenti projelerinde doğrudan kullanım için modüller ve sunucu kullanımı için bir eklenti modülü içerir.

🤝 Bu eklenti ne zaman faydalı olur

NMS’ye dokunmadan öğeler, varlıklar veya tile entities için güvenilir ve sürüm değişikliklerine dayanıklı NBT erişimine ihtiyacınız varsa, NBT-API eklenti geliştiricileri için bu verilerin okunmasını, yazılmasını ve kalıcı hale getirilmesini kolaylaştıran odaklanmış bir kütüphane sunar.