Minecraftサーバー DeluxeMenus プラグイン

## 🔌 DeluxeMenus について DeluxeMenus は、設定可能なインベントリベースの GUI メニューを作成するための Minecraft プラグインです。サーバー管理者は YAML でメニューとメニューアイテムを定義します。アイテムは PlaceholderAPI を通じて動的データを表示でき、クリック時にコマンドやアクションを実行できます。プラグインは外部メニューファイル用に `gui_menus` フォルダを生成し、コア設定には中央の `config.yml` を使用します。 ## 🎯 目的 DeluxeMenus は、コードを書かずにゲーム内のグラフィカルメニューを作成する問題を解決します。サーバー所有者は、ショップ、サーバーセレクター、キットメニュー、情報パネル、その他のインタラクティブなインターフェースを作成でき、それらはコマンドを実行したり、プレイヤーごとのデータを表示したりできます。 ## ⚙️ 機能 - YAML でインベントリ GUI メニューを作成可能（外部メニューファイル対応）。 - メニューアイテムはクリック時にコマンドを実行したり、アクションを実行したりできます。 - PlaceholderAPI と連携し、アイテム名、lore、条件を動的に表示できます。 - メニューごと、クリックごとの権限設定（メニューアクセスとクリック制限）。 - メニューを開く、一覧表示する、再読み込みする、アクションを実行するためのコマンド。 - 初回起動時に `plugins/DeluxeMenus/gui_menus` とサンプルメニューファイルを生成します。 - 匿名統計のために bStats を使用します（無効化しない限り既定で有効）。 ## 🧩 対象ユーザー - ゲーム内のカスタム GUI（ショップ、セレクター、キット）を求めるサーバー所有者と管理者。 - GUI ベースのショップや情報メニューを使う SMP および survival サーバー。 - PlaceholderAPI の値を使った設定可能なメニューが必要なネットワーク。 ## 🏗️ 使用例 - プレイヤーをテレポートさせたり、サーバー接続コマンドを実行したりするサーバーセレクターメニュー。 - プレイヤーがアイテムをクリックすると購入コマンドを実行するショップメニュー。 - プレースホルダーを使ってプレイヤー固有の情報を表示するキット選択 GUI。 ## ⌨️ コマンド | **コマンド** | **説明** | **権限** | **アクセス** | |---|---|---|---| | `/dm open <menuName>` | 指定したメニューを自分用に開きます。 | `deluxemenus.open` | プレイヤー | | `/dm open <menuName> <player>` | 指定したメニューを他のプレイヤー用に開きます。 | `deluxemenus.open.others` | 管理者 | | `/dm list` | アクセス可能なすべてのメニューを一覧表示します。 | `deluxemenus.list` | プレイヤー | | `/dm reload` | DeluxeMenus の設定とメニューを再読み込みします。 | `deluxemenus.reload` | 管理者 | | `/dm execute <player> <action>` | 設定されたアクションを対象プレイヤーに実行します（制限あり）。 | op / console | 管理者 | ## 🔐 権限 | **権限** | **説明** | **既定** | |---|---|---| | `deluxemenus.open` | `/dm open` でメニューを開くことを許可します。 | 指定なし | | `deluxemenus.open.others` | 他のプレイヤー用にメニューを開くことを許可します。 | 指定なし | | `deluxemenus.list` | アクセス可能なメニューの一覧表示を許可します。 | 指定なし | | `deluxemenus.reload` | プラグイン設定の再読み込みを許可します。 | 指定なし | | `deluxemenus.clickmenu.<menuName>` | メニューごとのクリックメニューアクセスを制限するために使用される権限ノードです。 | 指定なし | ## ⚙️ インストール ### 📥 セットアップ - Spigot 用の公式 DeluxeMenus `.jar` をダウンロードし、サーバーの `plugins/` ディレクトリに配置してください。 - DeluxeMenus を実行する前に PlaceholderAPI がインストールされていることを確認してください（プレースホルダーを機能させるには PlaceholderAPI が必要です）。 - サーバーを起動または再起動すると、DeluxeMenus は `config.yml` と `gui_menus` フォルダを含む `plugins/DeluxeMenus` フォルダを作成します。 - サーバーコンソールでプラグインが正常に読み込まれたことを確認し、Java バージョンの警告がないか確認してください。 ### 📦 依存関係 - PlaceholderAPI（プレースホルダー対応に必要）。 ### 🧾 設定 - DeluxeMenus はメインの `config.yml` を使用し、`plugins/DeluxeMenus/gui_menus` に保存された外部 YAML メニューファイルをサポートします。 - プラグインから新しいメニューを作成すると、既定の外部メニューファイルが生成され、スロット、アイテム、プレースホルダー、アクションをカスタマイズできます。 ## 🧠 技術メモ - アイテム名、lore、条件の動的プレースホルダーには PlaceholderAPI が必要です。 - プラグインの最新リリースには Java 11 以上が必要です。 - DeluxeMenus は bStats を通じて匿名統計を収集します（必要に応じて無効化できます）。 - このプラグインはオープンソースで、公開リポジトリがあり、設定ガイド用のサンプルメニューと wiki を提供しています。 - 対応する Minecraft のバージョンはプロジェクトに一覧されています。導入前にサーバーバージョンとの互換性を確認してください。 ## 🤝 このプラグインが役立つ場面プレイヤー固有のデータを表示し、クリックでコマンドを実行できる、設定可能で YAML ベースのインベントリ GUI が必要なら、DeluxeMenus はショップ、セレクター、ゲーム内インターフェースをカスタムコードなしで作るための実用的な選択肢です。