Plugin de Minecraft skript-reflect

🔌 Acerca de skript-reflect

skript-reflect es un addon de Skript que expone capacidades de reflexión para scripts de Skript. Permite a los autores de scripts importar e interactuar con clases Java, llamar métodos, leer y escribir campos, crear proxies y definir o escuchar eventos personalizados, lo que permite que Skript acceda a APIs y comportamientos no disponibles mediante las expresiones integradas.

🎯 Propósito

El objetivo principal del plugin es servir de puente entre Skript y Java proporcionando utilidades de reflexión de bajo nivel. Resuelve las limitaciones en las que Skript no tiene una expresión o evento directo, permitiendo que autores avanzados de scripts y desarrolladores de addons llamen al runtime del servidor u otros plugins.

⚙️ Características

• Importar y referenciar clases Java desde Skript.
• Invocar métodos y construir objetos mediante reflexión.
• Leer y escribir campos de forma reflexiva.
• Crear proxies de clases y eventos personalizados utilizables dentro de Skript.
• Compatibilidad para escuchar eventos asíncronos.
• Mejoras y correcciones frente a forks anteriores (gestión de variables locales, correcciones de proxies de clase).
• Compatibilidad declarada con runtimes Java más nuevos (el mantenedor señala compatibilidad con Java 13+ y OpenJ9).

🧩 Para quién es

• Autores de scripts de Skript que necesitan acceso a APIs de Java u otros internals de plugins.
• Administradores de servidores que ejecutan comportamiento personalizado basado en Skript y quieren ampliar Skript sin escribir un plugin Java completo.
• Desarrolladores de addons que crean extensiones de Skript de mayor nivel usando reflexión.

🏗️ Casos de uso de ejemplo

• Acceder a una API de plugin para la que Skript no tiene una expresión nativa, llamando a sus métodos Java.
• Crear un tipo de evento personalizado en Java y activarlo/escucharlo desde Skript.
• Usar proxies para envolver interfaces Java y lograr comportamiento dinámico dentro de los scripts.

⚙️ Instalación

📥 Configuración

• Descarga el archivo JAR del plugin desde los lanzamientos oficiales del proyecto.
• Coloca el JAR en el directorio plugins/ de tu servidor, junto con Skript.
• Reinicia el servidor y revisa la consola para confirmar que skript-reflect se carga.

📦 Dependencias

• Requiere Skript 2.14 o superior.

🧠 Notas técnicas

• El proyecto se distribuye bajo la licencia MIT.
• El mantenedor indica que skript-reflect requiere Skript 2.14+ y soporta las mismas plataformas y versiones de Minecraft que Skript 2.14.
• La documentación y los lanzamientos del proyecto se mantienen en el repositorio oficial y en los recursos de documentación del proyecto.

🤝 Cuándo es útil este plugin

Si necesitas ampliar Skript con funcionalidades que no están expuestas por expresiones integradas o addons existentes (por ejemplo, llamar a las APIs de otros plugins o crear tipos de eventos personalizados), skript-reflect proporciona las herramientas de reflexión para hacerlo desde scripts de Skript sin escribir un plugin Java independiente.