Minecraftプラグイン InteractionVisualizer

🔌 InteractionVisualizer について

InteractionVisualizer は、機能ブロックや関連エンティティ（例: crafting tables, furnaces, enchantment tables）に対して、クライアント側の視覚表現とアニメーションを描画する Minecraft プラグインです。視覚効果は packet を通じてプレイヤーに送信され、サーバー側のブロックやエンティティは作成されません — これは純粋にクライアント側の表示であり、ワールドの状態には影響しません。

🎯 目的

このプラグインは、プレイヤーが GUI を使っている間にアイテム、進行状況、ホログラム、アニメーションを表示することで、よく使われる機能ブロックとのやり取りを近くのプレイヤーにも見えるようにします。ワールド内のインターフェースとプレイヤーがやり取りしたときに、より豊かで分かりやすい視覚的フィードバックを求めるサーバー運営者向けです。

⚙️ 特徴

• 多くの機能ブロックと、それに対応するアイテム/エンティティをアニメーション付きで視覚化します（crafting table、furnace、enchantment table など）。
• クライアント側のみの表示: 視覚効果は永続的または操作可能なサーバーエンティティを作成しません。
• ブロックごとの表示切り替えと、全体のモジュール切り替え。
• プレイヤーの切り替え状態はデータベースに保存されます（既定は SQLite、MySQL 対応）。
• プレイヤーの切り替え状態用に PlaceholderAPI のプレースホルダーを利用できます。
• アドオン向けの開発者 API / wiki を提供します。
• 一般的なプラグインとの連携状況を考慮し、アニメーションを無効化または調整できます（vanish プラグイン、OpenInv など）。

🧩 対象ユーザー

• ブロック操作に対して、より没入感のある視覚的フィードバックを求める Survival / SMP サーバー。
• サーバーのワールドデータを変更せずに、クライアント側の見た目を整えたい装飾系/ロールプレイ系サーバー。
• プレイヤーごとに視覚効果を任意で制御したいサーバー管理者。

🏗️ 使用例

• プレイヤーがレシピ欄を埋めると crafting table 上にアイテムが出現するように見せ、近くのプレイヤーが進行状況を確認できるようにする。
• プレイヤーが furnace の UI を操作している間、furnace の進行ホログラムと出現アイテムの視覚効果を表示する。
• プレイヤーが表示モジュールを切り替えられるようにする（itemstands、dropped items、holograms）。

⌨️ コマンド

🔐 権限

⚙️ インストール

📥 セットアップ

• 公式のプラグイン JAR と、必要な依存 JAR をダウンロードします。
• JAR ファイルをサーバーの plugins/ フォルダに配置します。
• サーバーを起動し、コンソールでプラグインが読み込まれたことを確認します。
• 必要に応じて設定を編集し、設定変更を反映するためにサーバーを再起動します。

📦 依存関係

• ProtocolLib（指定されている古いサーバー版 / packet 処理に必要）。
• LightAPI Fork（使用される古いバージョンで必要）。

プロジェクトが記載しているソフト/任意の連携（動作調整に使用）: EssentialsX、OpenInv、PlaceholderAPI、SuperVanish、PremiumVanish、CMI。

🧾 設定

• このプラグインは、プレイヤーごとの切り替えを既定で SQLite に保存し、サーバー間で永続保存するための MySQL もサポートしています。
• 各ブロック表示と各モジュールは、プラグイン設定から無効化できます。

🧠 技術的な注意

• Spigot の API を基に作られており、Paper およびいくつかの最新サーバービルドとの互換性も報告されています。
• 表示はクライアント側のみで、倒せる・永続的なサーバーエンティティは作成しません。
• このプラグインは、サードパーティ製アドオン向けの開発者 API を提供し、翻訳はコミュニティによって保守されています。
• プロジェクトには制限として、Minecraft 1.10.2 以前では動作しない可能性があると記載されています。

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

サーバー側の状態を変更せずに、プレイヤーの操作に対して控えめで装飾的な視覚フィードバックを与えたい場合、InteractionVisualizer は packet ベースのアニメーションとプレイヤーごとの制御を提供し、ワールドをそのままにしたまま没入感を高めます。