Minecraftプラグイン CommandPanels

🔌 CommandPanels について

CommandPanels は、サーバー向けに YAML ベースの GUI/メニューシステムを提供する Minecraft プラグインです。インベントリベースのパネル、ダイアログ（フォーム）パネル、そして Bedrock プレイヤー向けの Floodgate 対応パネルに重点を置いています。プロジェクトには、コマンドを実行し、動的なプレースホルダーを表示し、ロジックや権限に反応する、インタラクティブでデータ駆動型のメニューを作成するためのオンラインエディタと構造化フォーマットが含まれています。

🎯 目的

このプラグインは、ショップ、キット、ロビー、運営ツール、または独自のワークフロー向けに、柔軟でプログラム可能な GUI を必要とするサーバー管理者や開発者向けです。パネルがコマンドを実行し、条件をチェックし、アイテムをアニメーション表示し、他のシステムで使用するためのセッションデータや永続データを公開できるように設計されています。

⚙️ 機能

• アイテム操作、スロット配置、アニメーションチェーンを備えたインベントリパネル。
• プレイヤーからの入力や構造化フォームのためのダイアログパネル。
• Geyser/Floodgate 環境を通じて Bedrock プレイヤーに互換パネルを表示するための Floodgate パネル対応。
• 表示や挙動を制御するためのインラインロジックと条件（AND/OR/NOT 系の演算子）。
• コマンド/アクションシステム: open/close フック、クリック時アクション、外側クリック時アクション、条件付きコマンド実行。
• PlaceholderAPI 対応と、パネル内での動的プレースホルダー更新。
• パネルやコマンドをまたいで利用できるセッションデータと永続パネルデータ。
• 権限が変わったときにロジック全体の再解析を引き起こせる定期更新と権限オブザーバー。
• YAML のライブプレビューと構造チェックを備えたオンラインエディタ。

🧩 対象ユーザー

Paper 互換のモダンなサーバーを運営し、柔軟な GUI メニューを必要とする管理者やプラグイン開発者向けです。サバイバル/SMP サーバー、ミニゲームネットワーク、PvP ハブ、独自の管理/モデレーション用インターフェースが必要なサーバーに適しています。

🏗️ 使用例

• サーバーコマンドを実行し、特定の権限や経済残高が必要なキットまたはショップ GUI を作成する。
• プレイヤーのランクに応じた条件付き表示とアニメーションアイテムを使ったハブ移動メニューを構築する。
• Floodgate 専用のパネルバリアントを使って Bedrock 互換メニューを提供する。

⌨️ コマンド

（コマンドとその権限は、公式の CommandPanels ドキュメントに基づいています。）

🔐 権限

⚙️ インストール

📥 セットアップ

• 公式の CommandPanels .jar ファイルをダウンロードして、サーバーの plugins/ フォルダに配置します。
• サーバーを起動してプラグインデータを生成します。
• 初回起動後に plugins/CommandPanels を確認し、config.yml とパネル定義ファイルを含む panels/ フォルダを確認してください。

📦 依存関係

• PlaceholderAPI — 動的プレースホルダー用の任意依存ですが推奨です。
• Floodgate — Bedrock（Floodgate）パネル対応のための任意依存です。

🧾 設定

• パネルは panels/ ディレクトリに配置された YAML ファイルとして定義されます。整理のためにサブフォルダも使用できます。
• panels/ ディレクトリが削除されてプラグインを再起動すると、プラグインはサンプルパネルを生成します。

🧠 技術メモ

• 公式ドキュメントとリリースでは、モダンな v4 リリース向けの対応サーバープラットフォームとして Paper と Folia（Paper のフォーク）が案内されています。
• v4 のリリース系は最近の Minecraft サーバーバージョンに重点を置いており、パネル定義は実行時に解析される動的プレースホルダーと条件ロジックをサポートします。
• このプラグインは、パネルを開くための権限ノードとコマンドベースの API を公開します。パネル YAML を読み込み、open アクションを呼び出すことで、他のプラグインにライブラリとして組み込むこともできます。

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

動的データ、条件ロジック、Bedrock 互換性、オンラインエディタをサポートする構造化されたスクリプト可能な GUI システムが必要なら、CommandPanels は Paper ベースのサーバーやネットワークに適した、YAML ファーストの確立されたアプローチを提供します。