Minecraft eklentisi SCore

🔌 SCore Hakkında

SCore, Ssomar tarafından üretilen çekirdek/kütüphane eklentisidir ve tüm eklenti paketleri genelinde kullanılan ortak işlevleri merkezileştirir. Diğer Ssomar eklentilerinin dayandığı oyun içi düzenleyiciler ve çalışma zamanı özellikleri sunar; ayrıca tek başına kullanılarak özel mermiler oluşturmak ve çalıştırmak, değişkenleri yönetmek ve paketlenmiş özel komutları yürütmek için de kullanılabilir.

🎯 Amaç

SCore, eklenti geliştiricileri için, özellikle de Ssomar eklenti ailesi için, yeniden kullanılabilir bir temel sağlamak amacıyla vardır; böylece özellikler bir kez uygulanır ve birden çok eklenti tarafından kullanılır. Bir veya daha fazla Ssomar eklentisi çalıştıran ya da bu yeniden kullanılabilir mekanikleri sunucusunda kullanmak isteyen geliştiricilere ve sunucu yöneticilerine yöneliktir.

⚙️ Özellikler

• Özel mermiler oluşturmak ve düzenlemek için oyun içi düzenleyici.
• Başlatılabilen veya tetiklenebilen çalışma zamanı özel mermileri.
• NUMBER, STRING, LIST türleriyle genel ve oyuncu bazlı değişkenler.
• Değişkenler için placeholder desteği (diğer eklentilerde/ayar dosyalarında kullanılacak placeholder belirteçleri).
• Sunucu konsolundan veya diğer eklentilerden erişilebilen paketlenmiş/özel komut yürütme altyapısı.
• Diğer Ssomar eklentilerinin bağımlılığı olarak kullanılmak üzere tasarlanmıştır.

🧩 Kimler İçin

• Ssomar eklentileri (ExecutableItems, ExecutableBlocks vb.) çalıştıran sunucu sahipleri.
• Mermiler, değişkenler ve özel komut yürütme için yeniden kullanılabilir bir kütüphaneye ihtiyaç duyan geliştiriciler.
• Bu özellikler için hafif, sunucu içi düzenleyiciler isteyen yöneticiler.

🏗️ Örnek Kullanım Senaryoları

• Bir sunucu, özel mermi davranışlarını tanımlamak ve başlatmak için SCore’u ExecutableItems ile birlikte kullanır.
• Bir yönetici genel veya oyuncu bazlı değişkenler oluşturur ve bunları menüler ya da diğer eklentiler için placeholder olarak sunar.
• Bir eklenti geliştiricisi, değişken depolama ve komut paketlemeyi birden çok eklentide yeniden kullanmak için SCore’a bağımlı olur.

⌨️ Komutlar

Notlar: resmi belgeler ayrıca değişkenler için placeholder belirteçlerini de açıklar (ör. %score_variables_<var_name>% ve %score_variables_<var_name>_int%). İzin düğümleri, referans verilen eklenti meta verilerinde listelenmemiştir.

⚙️ Kurulum

📥 Kurulum

• İlgili eklenti sürümü için resmi SCore .jar dosyasını indirin.
• .jar dosyasını sunucunun plugins/ dizinine yerleştirin.
• Sunucuyu yeniden başlatın ve SCore’un yüklendiğini doğrulamak için konsolu kontrol edin.
• Başka Ssomar eklentileri çalıştırıyorsanız, projenin önerdiği şekilde sürüm sonekiyle eşleşen SCore build’ini kurun (SCore build’ini bağımlı eklenti build’iyle eşleştirin).

🧠 Teknik Notlar

• Onaylanmış desteklenen platformlar: Bukkit, Spigot, Paper, Purpur, Folia.
• Onaylanmış desteklenen Minecraft sürümleri: 1.21.x’ten 1.8.x’e kadar (proje tarafından listelenmiştir).
• Proje meta verileri kısıtlayıcı bir lisans etiketi (ARR / All Rights Reserved) listelerken, proje dağıtımı katkılar için bir Git deposuna da atıfta bulunur; bu öğeler resmi meta verilerde birlikte yer alır.
• SCore, diğer Ssomar eklentileri için bir kütüphane/bağımlılık olarak kurulmak üzere tasarlanmıştır; diğer eklentilerin çalışma zamanında çağırdığı özellikleri sunar.

🤝 Bu Eklenti Ne Zaman Faydalıdır

Ssomar eklentileri kullanıyorsanız ya da özel mermiler ve değişken placeholder’ları için hazır bir sunucu içi sisteme ihtiyaç duyuyorsanız, SCore bu eklentilerin dayandığı ortak çalışma zamanı ve düzenleyicileri sağlar; aynı mekanikleri yeniden uygulamanızı gerektirmez.