Plugin Minecraft skript-reflect

🔌 Tentang skript-reflect

skript-reflect adalah addon Skript yang mengekspos kemampuan reflection ke skrip Skript. Ini memungkinkan pembuat skrip mengimpor dan berinteraksi dengan class Java, memanggil method, membaca dan menulis field, membuat proxy, serta mendefinisikan atau mendengarkan custom event, sehingga Skript dapat menjangkau API dan perilaku yang tidak tersedia lewat expression bawaan.

🎯 Tujuan

Tujuan inti plugin ini adalah menjembatani Skript dan Java dengan menyediakan utilitas reflection tingkat rendah. Ini mengatasi keterbatasan ketika Skript tidak memiliki expression atau event langsung, dengan memungkinkan pembuat skrip lanjutan dan developer addon memanggil runtime server atau plugin lain.

⚙️ Fitur

• Mengimpor dan mereferensikan class Java dari Skript.
• Memanggil method dan membuat objek melalui reflection.
• Membaca dan menulis field secara reflektif.
• Membuat proxy class dan custom event yang bisa digunakan di dalam Skript.
• Dukungan untuk mendengarkan asynchronous event.
• Peningkatan dan perbaikan dibanding fork yang lebih lama (penanganan local variable, perbaikan class proxy).
• Kompatibilitas yang dinyatakan dengan runtime Java yang lebih baru (Java 13+ dan dukungan OpenJ9 disebut oleh maintainer).

🧩 Untuk Siapa Ini

• Pembuat skrip Skript yang membutuhkan akses ke API Java atau internals plugin lain.
• Administrator server yang menjalankan perilaku kustom berbasis Skript dan ingin memperluas Skript tanpa menulis plugin Java penuh.
• Developer addon yang membuat ekstensi Skript tingkat lebih tinggi menggunakan reflection.

🏗️ Contoh Penggunaan

• Mengakses API plugin yang tidak punya expression bawaan di Skript dengan memanggil method Java-nya.
• Membuat tipe custom event di Java lalu memicunya/mendengarkannya dari Skript.
• Menggunakan proxy untuk membungkus interface Java agar perilaku dinamis bisa digunakan di dalam skrip.

⚙️ Instalasi

📥 Penyiapan

• Unduh JAR plugin dari rilis resmi proyek.
• Letakkan JAR ke direktori plugins/ server Anda bersama Skript.
• Restart server dan periksa console untuk memastikan skript-reflect berhasil dimuat.

📦 Dependensi

• Memerlukan Skript 2.14 atau lebih baru.

🧠 Catatan Teknis

• Proyek ini didistribusikan di bawah lisensi MIT.
• Maintainer menyatakan skript-reflect memerlukan Skript 2.14+ dan mendukung platform serta versi Minecraft yang sama seperti yang didukung Skript 2.14.
• Dokumentasi dan rilis proyek dipelihara di repositori resmi proyek dan sumber dokumentasi.

🤝 Kapan Plugin Ini Berguna

Jika Anda perlu memperluas Skript dengan fungsi yang tidak diekspos oleh expression bawaan atau addon yang sudah ada (misalnya, memanggil API plugin lain atau membuat tipe custom event), skript-reflect menyediakan alat reflection untuk melakukannya dari skrip Skript tanpa menulis plugin Java mandiri.