Minecraftプラグイン CommandButtons

🔌 CommandButtons について

CommandButtons は、ブロックとのインタラクションにコマンドを紐づけるための Minecraft プラグインです。サーバー管理者は、ブロック（ボタン、看板、感圧板、またはクリック可能なブロック）にコマンドのセットを追加でき、プレイヤーが設定済みのブロックに触れるとそのコマンドが実行されます。プラグインは、コンソールとして、またはそのブロックを起動したプレイヤーとしてコマンドを実行でき、ゲーム内 GUI エディタでボタンとそのプロパティを管理できます。

🎯 目的

このプラグインは、プレイヤーにコマンド入力を求めずに、管理用またはゲームプレイ用の動作を行うインタラクティブなワールド要素を作成する問題を解決します。代表的な用途には、テレポートボード、キット選択、購入可能なアクション、ブロック操作で発動する独自の仕組みなどがあります。

⚙️ 機能

• 1つのコマンドボタンに無制限の数のコマンドを紐づけ可能（コンソールコマンドとプレイヤーコマンド）。
• コマンドボタンと設置場所を作成・編集するためのゲーム内エディタ GUI。
• プレイヤー別および全体のクールダウン。クールダウンはサーバー再起動後も保持されます。
• Vault 経由のオプション経済連携で、ボタン利用時にプレイヤーへ料金を請求可能。
• 特定のボタンの使用を制限するカスタム権限ノード。
• messages ファイルによるカスタマイズ可能なメッセージ。
• コマンドボタンごとに複数の場所を設定でき、1つの設定を多くのブロックに適用可能。
• 作成、編集、プラグインデータの再読み込み用の基本コマンドを用意。

🧩 対象ユーザー

• コマンドを実行するクリック可能なワールド要素を求めるサーバー管理者やビルダー。
• インタラクティブなメニューやテレポート/キット選択ボードが必要なミニゲーム・ロビー系サーバー。
• 経済プラグインを使い、利用ごとの課金を行いたいサーバー。

🏗️ 使用例

• スポーンのテレポートボードで、各ボタンがクリックしたプレイヤーを別々のアリーナへテレポートする。
• キット選択ウォールで、ボタンを押すとキットやメッセージを配布する一連のコマンドが実行される。
• 購入型アクションで、ボタンがゲーム内通貨を消費し、報酬コマンドを実行する。

⌨️ コマンド

🔐 権限

⚙️ インストール

📥 セットアップ

• 公式のプラグイン jar をダウンロードし、サーバーの plugins/ ディレクトリに配置します。
• サーバーを再起動し、コンソールログを確認してプラグインが正しく読み込まれたことを確認します。
• 提供されている /commandbuttons コマンドを使って、ゲーム内でボタン設定を作成・編集します。

📦 依存関係

• オプション: 経済の課金機能を有効にするために Vault が必要です。Vault と連携する経済プラグイン（例: EssentialsX economy）が、利用ごとの課金機能を使うために必要です。

🧠 技術メモ

• このプラグインは GUI エディタを提供し、カスタマイズ用の設定/メッセージファイルを作成します。
• クールダウンはサーバー再起動後も保持されます。
• コンソール実行とプレイヤー実行の両方に対応しています。プレイヤーとして実行されたコマンドはそのプレイヤーの権限を使用します（プレイヤーより高い権限を必要とするコマンドは、プレイヤーとして実行しても動作しません）。
• 経済機能には Vault と対応する経済プラグインが必要です。

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

CommandButtons は、プレイヤー操作（ボタン、看板、感圧板）で発動する、設定可能で場所に紐づいたアクションが必要なときに便利です。クールダウン、権限チェック、オプションの経済コストを備え、ゲーム内エディタで管理できます。