Minecraft plugin skript-reflect

🔌 O skript-reflect

skript-reflect je addon pro Skript, který zpřístupňuje možnosti reflection pro skripty ve Skriptu. Umožňuje autorům skriptů importovat a používat Java třídy, volat metody, číst a zapisovat pole, vytvářet proxy a definovat nebo poslouchat vlastní události, takže Skript může dosáhnout na API a chování, která nejsou dostupná pomocí vestavěných výrazů.

🎯 Účel

Hlavním účelem tohoto pluginu je propojit Skript a Javu pomocí nízkoúrovňových reflection nástrojů. Řeší omezení, kdy Skript nemá přímý výraz nebo událost, tím, že umožňuje pokročilým autorům skriptů a vývojářům addonů volat do runtime serveru nebo jiných pluginů.

⚙️ Funkce

• Import a používání Java tříd ze Skriptu.
• Volání metod a vytváření objektů přes reflection.
• Čtení a zápis polí pomocí reflection.
• Vytváření proxy tříd a vlastních událostí použitelných ve Skriptu.
• Podpora pro naslouchání asynchronním událostem.
• Vylepšení a opravy oproti starším forkům (zpracování lokálních proměnných, opravy class proxy).
• Uvedená kompatibilita s novějšími Java runtime (správce zmiňuje Java 13+ a podporu OpenJ9).

🧩 Pro koho je to určeno

• Autorům skriptů ve Skriptu, kteří potřebují přístup k Java API nebo interním částem jiných pluginů.
• Správcům serverů provozujícím vlastní chování na Skriptu, kteří chtějí Skript rozšířit bez psaní plnohodnotného Java pluginu.
• Vývojářům addonů, kteří pomocí reflection vytvářejí pokročilejší rozšíření Skriptu.

🏗️ Příklady použití

• Přístup k API pluginu, pro které Skript nemá nativní výraz, pomocí volání jeho Java metod.
• Vytvoření vlastního typu události v Javě a jeho spouštění/sledování ze Skriptu.
• Použití proxy pro obalení Java rozhraní a dosažení dynamického chování ve skriptech.

⚙️ Instalace

📥 Nastavení

• Stáhněte JAR pluginu z oficiálních vydání projektu.
• Umístěte JAR do složky plugins/ na vašem serveru vedle Skriptu.
• Restartujte server a zkontrolujte konzoli, abyste potvrdili, že se skript-reflect načetl.

📦 Závislosti

• Vyžaduje Skript 2.14 nebo novější.

🧠 Technické poznámky

• Projekt je distribuován pod licencí MIT.
• Správce uvádí, že skript-reflect vyžaduje Skript 2.14+ a podporuje stejné platformy a verze Minecraftu jako Skript 2.14.
• Dokumentace a vydání projektu jsou spravovány v oficiálním repozitáři a dokumentačních zdrojích projektu.

🤝 Kdy je tento plugin užitečný

Pokud potřebujete rozšířit Skript o funkce, které nejsou dostupné ve vestavěných výrazech nebo existujících addonech (například volání API jiných pluginů nebo vytváření vlastních typů událostí), skript-reflect poskytuje reflection nástroje, jak to udělat přímo ze skriptů Skriptu bez psaní samostatného Java pluginu.