Minecraft plugin skript-reflect

🔌 Over skript-reflect

skript-reflect is een Skript-addon die reflection-mogelijkheden beschikbaar maakt voor Skript-scripts. Het laat scriptauteurs Java-klassen importeren en ermee werken, methoden aanroepen, velden lezen en schrijven, proxies maken en custom events definiëren of beluisteren, waardoor Skript toegang krijgt tot API’s en gedrag die niet beschikbaar zijn via ingebouwde expressies.

🎯 Doel

Het hoofddoel van de plugin is Skript en Java met elkaar te verbinden door low-level reflection-tools te bieden. Het lost beperkingen op wanneer Skript geen directe expressie of event heeft, door gevorderde scriptauteurs en addon-ontwikkelaars Java-runtime van de server of andere plugins te laten aanroepen.

⚙️ Functies

• Java-klassen importeren en gebruiken vanuit Skript.
• Methoden aanroepen en objecten maken via reflection.
• Velden reflectief lezen en schrijven.
• Class proxies en custom events maken die in Skript gebruikt kunnen worden.
• Ondersteuning voor het luisteren naar asynchrone events.
• Verbeteringen en fixes ten opzichte van oudere forks (afhandeling van lokale variabelen, fixes voor class proxies).
• Vermelde compatibiliteit met nieuwere Java-runtimes (Java 13+ en OpenJ9-ondersteuning genoemd door de maintainer).

🧩 Voor wie is dit

• Scriptauteurs van Skript die toegang nodig hebben tot Java-API’s of interne onderdelen van andere plugins.
• Serverbeheerders die custom gedrag op basis van Skript draaien en Skript willen uitbreiden zonder een volledige Java-plugin te schrijven.
• Addon-ontwikkelaars die met reflection uitgebreidere Skript-extensies bouwen.

🏗️ Voorbeeldtoepassingen

• Toegang krijgen tot de API van een plugin waarvoor Skript geen native expressie heeft door de Java-methoden aan te roepen.
• Een custom eventtype maken in Java en dat vanuit Skript afvuren/beluisteren.
• Proxies gebruiken om Java-interfaces te omwikkelen voor dynamisch gedrag in scripts.

⚙️ Installatie

📥 Setup

• Download de plugin-JAR uit de officiële releases van het project.
• Plaats de JAR in de plugins/-map van je server naast Skript.
• Herstart de server en controleer de console om te bevestigen dat skript-reflect wordt geladen.

📦 Afhankelijkheden

• Vereist Skript 2.14 of nieuwer.

🧠 Technische notities

• Het project wordt gedistribueerd onder de MIT-licentie.
• De maintainer geeft aan dat skript-reflect Skript 2.14+ vereist en dezelfde platforms en Minecraft-versies ondersteunt als Skript 2.14.
• De documentatie en releases van het project worden onderhouden in de officiële repository en documentatiebronnen van het project.

🤝 Wanneer deze plugin nuttig is

Als je Skript wilt uitbreiden met functionaliteit die niet beschikbaar is via ingebouwde expressies of bestaande addons (bijvoorbeeld door andere plugins’ API’s aan te roepen of custom eventtypes te maken), biedt skript-reflect de reflection-tools om dat vanuit Skript-scripts te doen zonder een op zichzelf staande Java-plugin te schrijven.