Plugin Minecraft skript-reflect

🔌 À propos de skript-reflect

skript-reflect est un addon pour Skript qui expose des capacités de réflexion aux scripts Skript. Il permet aux auteurs de scripts d'importer et d'utiliser des classes Java, d'appeler des méthodes, de lire et d'écrire des champs, de créer des proxys et de définir ou écouter des événements personnalisés, ce qui permet à Skript d'accéder à des API et à des comportements non disponibles via les expressions intégrées.

🎯 Objectif

L'objectif principal du plugin est de faire le lien entre Skript et Java en fournissant des utilitaires de réflexion bas niveau. Il résout les limites de Skript lorsqu'aucune expression ou aucun événement direct n'est disponible, en permettant aux auteurs de scripts avancés et aux développeurs d'addons d'appeler le runtime du serveur ou d'autres plugins.

⚙️ Fonctionnalités

• Importer et référencer des classes Java depuis Skript.
• Appeler des méthodes et instancier des objets via la réflexion.
• Lire et écrire des champs par réflexion.
• Créer des proxys de classes et des événements personnalisés utilisables dans Skript.
• Prise en charge de l'écoute d'événements asynchrones.
• Améliorations et corrections par rapport à d'anciens forks (gestion des variables locales, corrections des proxys de classe).
• Compatibilité annoncée avec des runtimes Java plus récents (prise en charge de Java 13+ et d'OpenJ9 mentionnée par le mainteneur).

🧩 À qui s'adresse-t-il

• Les auteurs de scripts Skript qui ont besoin d'accéder aux API Java ou à l'interne d'autres plugins.
• Les administrateurs de serveurs utilisant des comportements personnalisés basés sur Skript et souhaitant étendre Skript sans écrire un plugin Java complet.
• Les développeurs d'addons qui créent des extensions Skript plus avancées à l'aide de la réflexion.

🏗️ Exemples d'utilisation

• Accéder à une API de plugin pour laquelle Skript n'a pas d'expression native en appelant ses méthodes Java.
• Créer un type d'événement personnalisé en Java et le déclencher/l'écouter depuis Skript.
• Utiliser des proxys pour encapsuler des interfaces Java et obtenir un comportement dynamique dans les scripts.

⚙️ Installation

📥 Configuration

• Téléchargez le fichier JAR du plugin depuis les publications officielles du projet.
• Placez le JAR dans le dossier plugins/ de votre serveur, à côté de Skript.
• Redémarrez le serveur et vérifiez la console pour confirmer que skript-reflect se charge.

📦 Dépendances

• Nécessite Skript 2.14 ou plus récent.

🧠 Notes techniques

• Le projet est distribué sous licence MIT.
• Le mainteneur indique que skript-reflect nécessite Skript 2.14+ et prend en charge les mêmes plateformes et versions de Minecraft que Skript 2.14.
• La documentation et les versions du projet sont maintenues dans le dépôt officiel du projet et dans ses ressources de documentation.

🤝 Quand ce plugin est utile

Si vous devez étendre Skript avec des fonctionnalités qui ne sont pas exposées par les expressions intégrées ou les addons existants (par exemple, appeler les API d'autres plugins ou créer des types d'événements personnalisés), skript-reflect fournit les outils de réflexion nécessaires pour le faire depuis des scripts Skript sans écrire de plugin Java autonome.