Minecraftプラグイン InteractiveChat

🔌 InteractiveChatについて

InteractiveChat は、Minecraft のプラグインで、プレイヤー名やキーワードをホバー表示やクリックアクション付きのインタラクティブな内容に置き換えたり、アイテム、インベントリ、エンダーチェストをチャット上で直接表示できるようにして、ゲーム内チャットを強化します。既存のチャット整形プラグインの上で動作するように設計されており、チャットシステムを置き換えるのではなく、パケットを変更します。

🎯 目的

InteractiveChat は、静的でテキストのみのチャットという問題に対して、インタラクティブな要素と豊富なプレースホルダーを追加することで解決し、プレイヤーがアイテムやツールの詳細、インベントリの内容をホバーやクリックの操作で共有できるようにします。さらに、プロキシネットワーク上でのサーバー間機能にも対応しており、バックエンドサーバー全体でインタラクティブチャット機能を使えます。

⚙️ 機能

• チャット内のプレイヤー名を、ホバー/クリックで反応するインタラクティブな内容に置き換えます。
• キーワード（例: [item]）で、手に持っているアイテムのプレビューをチャットに表示します。
• キーワード（例: [inv]）でプレイヤーのインベントリ内容をチャットに表示し、表示レイアウトを選べます。
• キーワード（例: [ender]）でエンダーチェストの内容をチャットに表示します。
• チャット用のカスタムインタラクティブキーワード/プレースホルダーを作成できます。
• サーバーバージョンが対応している場合、プレイヤーのメンションに対して任意の通知（サウンド、タイトル、アクションバー、ボスバー）を出せます。
• プロキシとバックエンドに設定されている場合、BungeeCord と Velocity のサーバー間サポートを提供します。
• PlaceholderAPI のプレースホルダーに対応し、アイテムの素材名をクライアント言語へ翻訳する機能と統合します。
• RGB カラーコードとカスタムフォントに対応しているサーバーでは、メッセージにそれらを使用できます（RGB の動作には 1.16+ が必要です）。

🧩 対象ユーザー

• より豊かなチャット操作やホバー/クリック可能な内容を求めるサーバー管理者。
• バックエンドサーバー間でインタラクティブチャットが必要な、プロキシ（BungeeCord/Velocity）を使うネットワーク。
• 外部 MOD なしで、プレイヤーにアイテムやインベントリをチャットで見せたいコミュニティ。

🏗️ 使用例

• プレイヤーがグローバルチャットで [item] と入力し、手に持っているアイテムのインタラクティブなツールチップを他の人が確認できるようにする。
• モデレーターが、サポートや確認のために、プレースホルダーとインラインのインベントリプレビューを使った整形済みチャットメッセージを送る。
• プロキシネットワークで、プロキシとバックエンドの両方にプラグインを導入し、メンションやプレースホルダーがサーバーをまたいで動作するようにする。

⌨️ コマンド

注: 上記は公式ソースで明示的に記載されたコマンドのみです。権限ノードは、プラグインの公式ドキュメントに記載がある場合のみ含めています。それ以外では、権限列は未指定と表示されます。

🔐 権限

（上記には、プラグインの公式ドキュメントで明示された権限ノードのみを掲載しています。）

⚙️ インストール

📥 セットアップ

• 公式のプラグイン JAR と必要な依存プラグインをダウンロードします。
• InteractiveChat.jar（および依存 JAR）をサーバーの plugins/ ディレクトリに配置します。
• サーバーを起動します。
• 必要に応じてプラグイン設定を編集し、サーバーを再起動して変更を適用します。

📦 依存関係

バックエンド（Spigot/Paper/etc.）サーバーで必要と確認されている依存関係:

• ProtocolLib または PacketEvents（関連するパケットモジュールを含む）
• PlaceholderAPI
• Vault

注意: 依存関係はプロキシソフトウェアには不要です。BungeeCord または Velocity でこのプラグインを使う場合は、プロキシとバックエンドの両方に InteractiveChat をインストールし、各バックエンドの設定で proxy/bungeecord オプションを有効にしてください。

🧠 技術メモ

• このプラグインはチャットをパケットレベルで変更します。バックエンドサーバー上のメッセージを捕捉/変更するには、パケットライブラリ（ProtocolLib または PacketEvents）が必要です。
• プロキシ対応: BungeeCord と Velocity がサポートされています。サーバー間のプレースホルダーとメンションを有効にするには、プラグインをプロキシとすべてのバックエンドサーバーにインストールし、各バックエンドの設定で bungeecord オプションを有効にする必要があります。
• PlaceholderAPI はプレースホルダーの解決に使われ、必要な拡張機能はそれぞれ別途インストールする必要があります。
• アイテムの素材名は、該当する場合、各プレイヤーのクライアント言語に翻訳されます。
• RGB カラーコードとカスタムフォントタグは、それらの機能をサポートするサーバー/クライアントで使用できます（RGB の動作には、一般的に 1.16+ で利用できるサーバー/クライアントの対応が必要です）。

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

既存のチャット整形プラグインをそのまま使いながら、確認可能なアイテム/ツールのプレビュー、インベントリ共有、クリック可能なチャットキーワード、サーバー間のインタラクティブチャット機能を追加したいなら、InteractiveChat は標準のチャットシステムの上にインタラクティブな内容を重ねるパケットレベルの統合を提供します。