Minecraftプラグイン MyCommand

🔌 MyCommand について

MyCommand は、Java を書かずにカスタムコマンド、エイリアス、そしてコマンド駆動のインタラクティブなインターフェースを作成できる Minecraft プラグインです。YAML ベースのシステムで、ほかのコマンドを実行したり、整形テキストを送信したり、GUI を開いたり、スクリプトを起動したり、イベントと連携したりするコマンドを定義できます。

🎯 目的

MyCommand は、柔軟なカスタムコマンド、ショートカット、管理者/ユーザー向けインターフェースを必要とするサーバー管理者向けです。遅延、ウォームアップ、クールダウン、タブ補完、プレースホルダーなどの独自のコマンド動作や、軽量な GUI 連携を、フル機能のプラグインを開発せずに追加できます。

⚙️ 特徴

• 新しいコマンドとエイリアスを作成し、必要に応じてタブ補完に登録できます。
• 1 つのカスタムコマンドから複数のコマンドを実行できます（コンソール実行またはプレイヤー実行）。
• コマンドに遅延、ウォームアップ、クールダウンを設定できます。
• ほかのコマンドを上書きしたり、ショートカット/エイリアスを提供したりできます。
• アイテム、ブロック、看板、本、NPC、アイテムフレームからコマンドを発火できます。
• GUI 要素: チェストベースの IconMenu、ActionBar、BossBar、Title、Scoreboard、Anvil GUI、Sign GUI。
• 動的な動作のためのプレースホルダー対応と、スクリプトのような条件分岐。
• 経済連携（Vault 経由で任意）と、いくつかの単体経済機能。
• プレイヤーイベント（参加/退出/死亡）とスケジュールタスクのサポート。
• SQL を使った任意のカスタムプレイヤーデータベースと、無制限のコマンド向けの複数ファイル対応。
• BungeeCord 関連機能と、プロキシ側コマンド用の別 Bungee 側バリアント。
• HTTP リクエスト（GET/POST）と、利用可能な環境での MiniMessage フォーマット対応。
• メトリクス報告に bStats を使用します。

🧩 対象ユーザー

• コーディングなしでカスタムコマンドやメニューを使いたい Survival / SMP サーバー。
• カスタムのショップ/コマンドフローが必要な、管理要素の強いサーバーや経済サーバー。
• 中央集約型またはプロキシ側のコマンド動作が必要なプロキシネットワーク。
• 動的な出力のためにスクリプト化された条件分岐とプレースホルダーが必要なサーバー運営者。

🏗️ 使用例

• ショップを開き、アイテムを付与し、購入を記録する一連のコンソールコマンドを実行する単一コマンドを定義する。
• chest GUI の項目や anvil/sign の入力を使って、罰則/テレポート用の GUI メニューを作成する。
• タブ補完付きで、より長い BungeeCord のサーバー切り替えコマンドに対応する短いエイリアスを提供する。

⌨️ コマンド

公式ドキュメントには、プラグイン管理用の管理コマンドが記載されています。プロジェクトで示されている例は以下のとおりです。

（完全な一覧と正確な構文は、プラグインの公式コマンド документацию を参照してください。）

🔐 権限

このプロジェクトは、管理操作向けの権限ノードを記載しています。公式の権限一覧にある例は以下のとおりです。

（権限の全体マップは、プラグインの権限ドキュメントを参照してください。）

⚙️ インストール

📥 セットアップ

• 公式 .jar プラグインをダウンロードし、サーバーの plugins/ フォルダに配置します。
• サーバーを起動または再起動し、コンソールログでプラグインが読み込まれたことを確認します。
• 読み込みに失敗する場合は、必要/任意のサポートプラグイン（依存関係を参照）が導入済みか、更新済みかを確認してください。

📦 依存関係

• ProtocolLib — プラグインが読み込まれない場合や一部機能で重要とされています。
• Vault — 任意。経済連携に必要です。
• PlaceholderAPI — 任意。プレースホルダー対応を拡張します。

目的の機能に対して確認できた依存関係だけを導入してください。多くの連携は任意です。

🧠 技術メモ

• プラグインは YAML ファイルで設定され、コマンド制限を回避するために複数のコマンドファイルをサポートします。
• SQL ストレージはカスタムプレイヤーデータベース（任意）に利用でき、複数ファイル構成もサポートされています。
• プロキシ側のコマンド処理用に、別の BungeeCord コンポーネントがあります。
• このプロジェクトは bStats を通じてメトリクスを報告します。
• 対応環境では MiniMessage フォーマットとタブ補完のサポートが利用できます。

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

Java を書かずに、柔軟なファイル駆動のカスタムコマンド、条件付きスクリプト、GUI ベースのコマンドフローが必要なら、MyCommand はそれらの要件に対応する設定可能な基盤を提供し、必要に応じてプロキシ連携と経済連携も追加します。