Minecraftプラグイン skript-reflect

🔌 skript-reflect について

skript-reflect は、Skript のスクリプトに対してリフレクション機能を公開する Skript アドオンです。これにより、スクリプト作者は Java クラスをインポートして操作したり、メソッドを呼び出したり、フィールドを読み書きしたり、プロキシを作成したり、カスタムイベントを定義または監視したりできます。Skript だけでは使えない API や動作にもアクセスできるようになります。

🎯 目的

このプラグインの主な目的は、低レベルのリフレクションユーティリティを提供して Skript と Java をつなぐことです。Skript に直接使える式やイベントがない場合の制約を解消し、上級スクリプト作者やアドオン開発者がサーバーのランタイムや他のプラグインを呼び出せるようにします。

⚙️ 機能

• Skript から Java クラスをインポートして参照できる。
• リフレクションを使ってメソッドを呼び出し、オブジェクトを生成できる。
• フィールドをリフレクションで読み書きできる。
• Skript 内で使えるクラスプロキシやカスタムイベントを作成できる。
• 非同期イベントの監視に対応。
• 古いフォークより改善・修正済み（ローカル変数の扱い、クラスプロキシの修正など）。
• 新しい Java ランタイムとの互換性があるとされている（Java 13+ と OpenJ9 の対応がメンテナーにより記載）。

🧩 対象ユーザー

• Java API や他のプラグイン内部へのアクセスが必要な Skript スクリプト作者。
• Skript ベースのカスタム動作を運用し、完全な Java プラグインを書かずに Skript を拡張したいサーバー管理者。
• リフレクションを使ってより高機能な Skript 拡張を作るアドオン開発者。

🏗️ 使用例

• Skript にネイティブの式がないプラグイン API に、その Java メソッドを呼び出してアクセスする。
• Java でカスタムイベント型を作成し、Skript から発火・監視する。
• プロキシを使って Java インターフェースをラップし、スクリプト内で動的な振る舞いを実現する。

⚙️ インストール

📥 セットアップ

• プロジェクトの公式リリースからプラグインの JAR をダウンロードします。
• JAR を Skript と一緒にサーバーの plugins/ ディレクトリへ入れます。
• サーバーを再起動し、コンソールで skript-reflect が読み込まれていることを確認します。

📦 依存関係

• Skript 2.14 以降が必要です。

🧠 技術メモ

• このプロジェクトは MIT ライセンスで配布されています。
• メンテナーによると、skript-reflect は Skript 2.14+ が必要で、Skript 2.14 が対応するのと同じプラットフォームと Minecraft バージョンをサポートします。
• プロジェクトのドキュメントとリリースは、公式リポジトリとドキュメント資源で管理されています。

🤝 このプラグインが役立つ場面

組み込みの式や既存アドオンでは公開されていない機能で Skript を拡張したい場合（たとえば、他のプラグインの API を呼び出したり、カスタムイベント型を作成したりする場合）、skript-reflect は、単体の Java プラグインを書かずに Skript スクリプトからそれを行うためのリフレクションツールを提供します。