Plugin Minecraft skript-reflect

🔌 O skript-reflect

skript-reflect to dodatek do Skript, który udostępnia możliwości refleksji skryptom Skript. Pozwala autorom skryptów importować i wykorzystywać klasy Java, wywoływać metody, odczytywać i zapisywać pola, tworzyć proxy oraz definiować lub nasłuchiwać własne zdarzenia, umożliwiając Skriptowi dostęp do API i zachowań niedostępnych przez wbudowane wyrażenia.

🎯 Cel

Głównym celem wtyczki jest połączenie Skript i Javy poprzez udostępnienie niskopoziomowych narzędzi refleksji. Rozwiązuje ona ograniczenia, w których Skript nie ma bezpośredniego wyrażenia ani zdarzenia, pozwalając zaawansowanym autorom skryptów i twórcom dodatków wywoływać funkcje środowiska serwera lub innych wtyczek.

⚙️ Funkcje

• Importowanie i odwoływanie się do klas Java w Skript.
• Wywoływanie metod i tworzenie obiektów przez refleksję.
• Odczyt i zapis pól poprzez refleksję.
• Tworzenie proxy klas i własnych zdarzeń użytecznych wewnątrz Skript.
• Obsługa nasłuchiwania zdarzeń asynchronicznych.
• Ulepszenia i poprawki względem starszych forków (obsługa zmiennych lokalnych, poprawki proxy klas).
• Zadeklarowana zgodność z nowszymi środowiskami Java (maintainer wskazuje obsługę Java 13+ i OpenJ9).

🧩 Dla kogo

• Autorzy skryptów Skript, którzy potrzebują dostępu do API Java lub wewnętrznych elementów innych wtyczek.
• Administratorzy serwerów używający niestandardowych zachowań opartych na Skript, którzy chcą rozszerzyć Skript bez pisania pełnej wtyczki Java.
• Twórcy dodatków budujący wyższy poziom rozszerzeń Skript z użyciem refleksji.

🏗️ Przykładowe zastosowania

• Uzyskanie dostępu do API wtyczki, dla którego Skript nie ma natywnego wyrażenia, poprzez wywołanie jej metod Java.
• Utworzenie niestandardowego typu zdarzenia w Javie i wyzwalanie go lub nasłuchiwanie z poziomu Skript.
• Użycie proxy do opakowania interfejsów Java i uzyskania dynamicznego zachowania wewnątrz skryptów.

⚙️ Instalacja

📥 Konfiguracja

• Pobierz plik JAR wtyczki z oficjalnych wydań projektu.
• Umieść plik JAR w katalogu plugins/ na serwerze, obok Skript.
• Uruchom ponownie serwer i sprawdź konsolę, aby potwierdzić, że skript-reflect się ładuje.

📦 Zależności

• Wymaga Skript 2.14 lub nowszego.

🧠 Uwagi techniczne

• Projekt jest منتشرzony na licencji MIT.
• Utrzymujący stwierdza, że skript-reflect wymaga Skript 2.14+ i obsługuje te same platformy oraz wersje Minecrafta, które obsługuje Skript 2.14.
• Dokumentacja i wydania projektu są utrzymywane w oficjalnym repozytorium oraz zasobach dokumentacyjnych projektu.

🤝 Kiedy ta wtyczka jest przydatna

Jeśli chcesz rozszerzyć Skript o funkcje, które nie są udostępniane przez wbudowane wyrażenia lub istniejące dodatki (na przykład wywoływanie API innych wtyczek lub tworzenie własnych typów zdarzeń), skript-reflect dostarcza narzędzia refleksji, aby zrobić to ze skryptów Skript bez pisania samodzielnej wtyczki Java.