Minecraft eklentisi eco

🔌 eco hakkında

eco, plugin geliştirmeyi basitleştirmek ve diğer eklentiler için yeniden kullanılabilir motor özellikleri sunmak üzere tasarlanmış bir Spigot geliştirme kütüphanesidir (bağımsız bir Minecraft eklentisi). Komut ve yapılandırma API’leri, kalıcı depolama bağdaştırıcıları, GUI ve özel öğe sistemleri ile çok sayıda entegrasyon sunar; böylece eklenti geliştiricileri ortak işlevleri yeniden yazmak yerine yeniden kullanabilir.

🎯 Amaç

eco, modern eklentilerin ihtiyaç duyduğu geliştirici odaklı ortak sistemleri tek yerde toplamak için vardır: komut ayrıştırma, renk ve mesaj biçimleri, yapılandırma biçimleri, kalıcı veri erişimi, GUI bileşenleri, eşya yönetimi ve diğer sunucu tarafı sistemlerle entegrasyonlar. Bakımlı, paylaşılan bir çatı üzerinde özelliklerini hızlıca geliştirmek isteyen eklenti yazarları için tasarlanmıştır.

⚙️ Özellikler

• Modern komut API’si ve ayrıştırma
• Hex / RGB / MiniMessage desteğiyle yerleşik renk ayrıştırma
• YAML, JSON ve TOML destekleyen config sistemi
• YAML, MySQL ve MongoDB arka uçlarıyla kalıcı veri depolama API’si
• GUI API’si ve hazır bileşenler
• Özel öğeler ve ultra hızlı ItemStack işleme
• Paket tabanlı öğe gösterimi ve hafif paket olay döngüsü
• NMS ile neredeyse 1:1 eşlemeli entity AI API’si
• Placeholder API ve yerleşik entegrasyonlar (proje tarafından listelenen 30+ entegrasyon)
• Fiyat/ekonomi soyutlaması (ekonomi eklentileri, XP ve öğeleri destekleyen fiyat sistemi)
• Yerleşik bStats desteği ve eklenti güncelleme kontrolü
• Genişletme sistemi (eklenti için eklentiler) ve geliştiriciler için dependency injection araçları

🧩 Kimler İçin

• Yeniden kullanılabilir bir çatı isteyen, Spigot/Paper uyumlu eklentiler geliştiren eklenti geliştiricileri
• eco’ya bağımlı eklentileri çalıştıran sunucu sahipleri (eco’nun bağımlılık olarak kurulması gerekir)
• Özel öğeler, GUI’ler veya birleşik kalıcılık ve komut araçları gerektiren projeler

🏗️ Örnek Kullanım Alanları

• Bir geliştirici, eco’nun öğe arama ve GUI API’lerini kullanan özel bir öğe paketi uygular.
• Bir eklenti, kodu çoğaltmadan hem yerel YAML’ı hem de uzak bir MongoDB arka ucunu desteklemek için eco’nun depolama API’sini kullanır.
• Birden fazla küçük eklenti, tutarlı komut işleme ve renk ayrıştırma için eco’yu paylaşır.

⚙️ Kurulum

📥 Kurulum

• eco’yu ihtiyaç duyan herhangi bir sunucuya eklenti olarak kurmak için JAR dosyasını sunucunun plugins/ klasörüne yerleştirin ve sunucuyu yeniden başlatın.
• Başka bir eklenti eco’ya bağlıysa, o eklentinin plugin.yml dosyasında depend: altında - eco olarak belirtin; böylece sunucu önce eco’yu yükler.

📦 Bağımlılık (eklenti geliştiricileri için)

• Proje, compile-only kullanım için bir Maven deposu ve Gradle koordinatları yayımlar. Proje ayrıca yayınlanmış bir artefakt sunar (örneğin com.willfp grubu ve sürüm etiketleriyle), böylece geliştiriciler eco’yu build sırasında provided bağımlılık olarak ekleyebilir.

🧠 Teknik Notlar

• Desteklenen sunucu yazılımları: resmi proje Spigot, Paper, Purpur ve Folia desteğini belirtir.
• Desteklenen Minecraft sürümleri: proje 1.21.4’ten itibaren destek sunduğunu belirtir; sonraki sürümler modern 1.21.x serisini hedefler.
• Depolama arka uçları: YAML, MySQL ve MongoDB bağdaştırıcıları framework tarafından sağlanır.
• Lisanslama: eco, MIT lisansı altında yayınlanır.

🤝 Bu Eklenti Ne Zaman İşe Yarar

Eğer komutlar, config biçimleri, GUI bileşenleri, depolama, özel öğeler gibi ortak ihtiyaçları paylaşan birden fazla özellik veya eklenti geliştiriyorsanız, eco bakımlı bir çatı ve diğer eklentilerin bağımlı olabileceği entegrasyonlar sunarak tekrar eden işi azaltır.