Minecraft-Plugin skript-reflect

🔌 Über skript-reflect

skript-reflect ist ein Skript-Addon, das Skript-Skripten Reflection-Funktionen bereitstellt. Es ermöglicht Skript-Autoren, Java-Klassen zu importieren und mit ihnen zu arbeiten, Methoden aufzurufen, Felder zu lesen und zu schreiben, Proxys zu erstellen sowie benutzerdefinierte Events zu definieren oder auf sie zu hören. So kann Skript auf APIs und Verhaltensweisen zugreifen, die über die eingebauten Ausdrücke nicht verfügbar sind.

🎯 Zweck

Der Hauptzweck des Plugins besteht darin, Skript und Java durch Low-Level-Reflection-Utilities miteinander zu verbinden. Es behebt Einschränkungen, wenn Skript keinen direkten Ausdruck oder kein direktes Event bietet, indem fortgeschrittene Skript-Autoren und Addon-Entwickler auf den Server-Runtime-Kontext oder andere Plugins zugreifen können.

⚙️ Funktionen

• Java-Klassen in Skript importieren und referenzieren.
• Methoden aufrufen und Objekte per Reflection erstellen.
• Felder reflektiv lesen und schreiben.
• Klassenproxies und benutzerdefinierte Events erstellen, die in Skript genutzt werden können.
• Unterstützung für das Lauschen auf asynchrone Events.
• Verbesserungen und Fehlerbehebungen gegenüber älteren Forks (Verwaltung lokaler Variablen, Korrekturen bei Klassen-Proxys).
• Angegebene Kompatibilität mit neueren Java-Runtimes (Java 13+ und OpenJ9-Support werden vom Maintainer erwähnt).

🧩 Für wen es ist

• Skript-Autoren, die Zugriff auf Java-APIs oder interne Funktionen anderer Plugins benötigen.
• Server-Administratoren mit Skript-basiertem Custom-Behavior, die Skript erweitern möchten, ohne ein komplettes Java-Plugin zu schreiben.
• Addon-Entwickler, die mit Reflection höherwertige Skript-Erweiterungen bauen.

🏗️ Beispielanwendungen

• Auf eine Plugin-API zugreifen, für die Skript keinen nativen Ausdruck hat, indem deren Java-Methoden aufgerufen werden.
• Einen benutzerdefinierten Event-Typ in Java erstellen und ihn von Skript aus auslösen/abhören.
• Proxys verwenden, um Java-Interfaces für dynamisches Verhalten in Skripten zu umhüllen.

⚙️ Installation

📥 Einrichtung

• Lade die JAR-Datei des Plugins aus den offiziellen Releases des Projekts herunter.
• Lege die JAR-Datei in das plugins/-Verzeichnis deines Servers, zusammen mit Skript.
• Starte den Server neu und prüfe die Konsole, um zu bestätigen, dass skript-reflect geladen wird.

📦 Abhängigkeiten

• Erfordert Skript 2.14 oder neuer.

🧠 Technische Hinweise

• Das Projekt wird unter der MIT-Lizenz veröffentlicht.
• Der Maintainer gibt an, dass skript-reflect Skript 2.14+ benötigt und dieselben Plattformen und Minecraft-Versionen unterstützt, die auch Skript 2.14 unterstützt.
• Die Projektdokumentation und Releases werden im offiziellen Repository und in den Dokumentationsressourcen des Projekts gepflegt.

🤝 Wann dieses Plugin nützlich ist

Wenn du Skript um Funktionen erweitern möchtest, die nicht durch eingebaute Ausdrücke oder vorhandene Addons bereitgestellt werden (zum Beispiel das Aufrufen der APIs anderer Plugins oder das Erstellen benutzerdefinierter Event-Typen), bietet skript-reflect die Reflection-Werkzeuge, um das direkt aus Skript-Skripten zu tun, ohne ein eigenständiges Java-Plugin zu schreiben.