Minecraft plugin skript-reflect

🔌 About skript-reflect

skript-reflect is a Skript addon that exposes reflection capabilities to Skript scripts. It lets script authors import and interact with Java classes, call methods, read and write fields, create proxies, and define or listen to custom events, enabling Skript to reach APIs and behaviors not available through built-in expressions.

🎯 Purpose

The plugin's core purpose is to bridge Skript and Java by providing low-level reflection utilities. It solves limitations where Skript lacks a direct expression or event by letting advanced script authors and addon developers call into the server runtime or other plugins.

⚙️ Features

• Import and reference Java classes from Skript.
• Invoke methods and construct objects via reflection.
• Read and write fields reflectively.
• Create class proxies and custom events usable inside Skript.
• Support for listening to asynchronous events.
• Improvements and fixes over older forks (local variable handling, class proxy fixes).
• Stated compatibility with newer Java runtimes (Java 13+ and OpenJ9 support noted by the maintainer).

🧩 Who It Is For

• Skript script authors who need access to Java APIs or other plugin internals.
• Server administrators running Skript-based custom behaviour who want to extend Skript without writing a full Java plugin.
• Addon developers who build higher-level Skript extensions using reflection.

🏗️ Example Use Cases

• Access a plugin API that Skript has no native expression for by calling its Java methods.
• Create a custom event type in Java and fire/listen for it from Skript.
• Use proxies to wrap Java interfaces for dynamic behavior inside scripts.

⚙️ Installation

📥 Setup

• Download the plugin JAR from the project's official releases.
• Place the JAR into your server's plugins/ directory alongside Skript.
• Restart the server and check the console to confirm skript-reflect loads.

📦 Dependencies

• Requires Skript 2.14 or newer.

🧠 Technical Notes

• The project is distributed under the MIT license.
• The maintainer states skript-reflect requires Skript 2.14+ and supports the same platforms and Minecraft versions supported by Skript 2.14.
• The project documentation and releases are maintained in the project's official repository and documentation resources.

🤝 When This Plugin Is Useful

If you need to extend Skript with functionality that isn't exposed by built-in expressions or existing addons (for example, calling into other plugins' APIs or creating custom event types), skript-reflect provides the reflective tools to do that from Skript scripts without writing a standalone Java plugin.