Minecraft eklentisi skript-reflect

🔌 skript-reflect hakkında

skript-reflect, Skript betiklerine yansıma (reflection) yetenekleri sunan bir Skript eklentisidir. Betik yazarlarının Java sınıflarını içe aktarmasına ve onlarla etkileşime geçmesine, metot çağırmasına, alanları okumasına ve yazmasına, proxy oluşturmasına ve özel olaylar tanımlamasına ya da dinlemesine olanak tanır; böylece Skript'in yerleşik ifadelerle erişemediği API'lere ve davranışlara ulaşmasını sağlar.

🎯 Amaç

Eklentinin temel amacı, düşük seviyeli yansıma araçları sağlayarak Skript ile Java arasında köprü kurmaktır. Skript'in doğrudan bir ifade veya olaya sahip olmadığı durumlarda oluşan sınırlamaları çözer; gelişmiş betik yazarlarının ve addon geliştiricilerinin sunucu çalışma zamanına veya diğer eklentilere çağrı yapmasına izin verir.

⚙️ Özellikler

• Java sınıflarını Skript içinde içe aktarma ve referans verme.
• Metot çağırma ve nesneleri yansımayla oluşturma.
• Alanları yansımalı olarak okuma ve yazma.
• Skript içinde kullanılabilen sınıf proxy'leri ve özel olaylar oluşturma.
• Asenkron olayları dinleme desteği.
• Eski fork'lara göre iyileştirmeler ve düzeltmeler (yerel değişken işleme, sınıf proxy düzeltmeleri).
• Daha yeni Java çalışma zamanlarıyla uyumluluk iddiası (Java 13+ ve OpenJ9 desteği bakımcı tarafından belirtilmiştir).

🧩 Kimler için

• Java API'lerine veya diğer eklentilerin iç işleyişine erişmesi gereken Skript betik yazarları.
• Tam bir Java eklentisi yazmadan Skript'i genişletmek isteyen, Skript tabanlı özel davranışlar çalıştıran sunucu yöneticileri.
• Yansıma kullanarak daha üst düzey Skript uzantıları geliştiren addon geliştiricileri.

🏗️ Örnek kullanım senaryoları

• Skript'in yerleşik bir ifadesi olmayan bir eklenti API'sine, onun Java metotlarını çağırarak erişmek.
• Java'da özel bir olay türü oluşturup bunu Skript'ten tetiklemek/dinlemek.
• Proxy'leri kullanarak Java arayüzlerini sarmalamak ve betikler içinde dinamik davranış sağlamak.

⚙️ Kurulum

📥 Hazırlık

• Eklentinin JAR dosyasını projenin resmi sürümlerinden indirin.
• JAR dosyasını, Skript ile birlikte sunucunuzun plugins/ dizinine yerleştirin.
• Sunucuyu yeniden başlatın ve skript-reflect'in yüklendiğini doğrulamak için konsolu kontrol edin.

📦 Bağımlılıklar

• Skript 2.14 veya daha yeni sürümünü gerektirir.

🧠 Teknik Notlar

• Proje MIT lisansı altında dağıtılır.
• Bakımcı, skript-reflect'in Skript 2.14+ gerektirdiğini ve Skript 2.14'ün desteklediği platformlar ile Minecraft sürümlerinin aynısını desteklediğini belirtir.
• Proje belgeleri ve sürümleri, projenin resmi deposunda ve dokümantasyon kaynaklarında sürdürülür.

🤝 Bu eklenti ne zaman faydalıdır

Yerleşik ifadeler veya mevcut addon'lar tarafından sunulmayan işlevlerle Skript'i genişletmeniz gerekiyorsa (örneğin, diğer eklentilerin API'lerini çağırmak veya özel olay türleri oluşturmak), skript-reflect bunu ayrı bir Java eklentisi yazmadan Skript betiklerinden yapmanızı sağlayan yansıma araçlarını sunar.