Minecraftサーバー EconomyShopGUI プラグイン

## 🔌 EconomyShopGUI について EconomyShopGUI は、Minecraft のプラグインで、設定可能なグラフィカルなショップシステムを提供し、プレイヤーがチャットコマンドではなくメニューからアイテムを売買できるようにします。プラグインには、ショップセクション、ページ分割されたショップページ、売却インターフェース、そして任意の物理的な「ShopStand」アイテムが用意されています。Bukkit/Spigot/Paper サーバー環境向けに設計されており、一般的な経済プラグインと連携します。 ## 🎯 目的 このプラグインは、テキストベースのショップコマンドを GUI ベースのショップと管理用のショップ設定に置き換える、または補完します。既存の経済プラグインに接続する、構造化された設定可能なゲーム内ショップを求めるサーバーオーナーや管理者向けです。 ## ⚙️ 機能 - 設定可能なショップセクションとページ分割された GUI ページ。 - 取引画面と設定可能な制限を備えた、購入・売却のフロー。 - 全体およびセクションごとの sell-all 機能。 - ShopStand の物理アイテム対応（設置できる展示ショップ）。 - レイアウトのマーケットプレイス / インストール可能なレイアウト / ゲーム内でのレイアウト導入。 - 他のプラグインから本プラグインに接続するための開発者向け API。 - 複数の経済システムとの統合、およびスポナー系・ユーティリティ系プラグイン向けの任意統合。 - 匿名のプラグイン統計に bStats を使用。 ## 🧩 対象ユーザー - ゲーム内 GUI ショップを求める Survival や SMP サーバー。 - すでに別の経済プラグインを使っていて、フロントエンドのショップ UI が必要なサーバー。 - 設定可能なショップレイアウトや任意の物理ショップスタンドを求めるサーバー。 - ショップの動作を統合するためのショップ API が必要なプラグイン開発者。 ## 🏗️ 使用例 - 運営者が資源、道具、装飾品用のショップセクションを作成し、プレイヤーが GUI から購入できるようにする。 - サーバーが /sellall コマンドを提供し、プレイヤーが設定済みのショップセクションにアイテムを売れるようにする。 - 管理者がレイアウトをインストールまたはアップロードして、元ファイルを編集せずにショップの見た目を変更する。 ## ⌨️ コマンド | **コマンド** | **説明** | **権限** | **アクセス** | |---|---|---|---| | `/eshop additem <section> <material> <buy price> <sell price>` | ショップセクションにアイテムを追加します。 | `EconomyShopGUI.eshop.additem` | 管理者 | | `/eshop edititem <section> <index> <action> <key> <value>` | セクション内のアイテムのプロパティを編集します。 | `EconomyShopGUI.eshop.edititem` | 管理者 | | `/eshop deleteitem <section> <index>` | ショップセクションからアイテムを削除します。 | `EconomyShopGUI.eshop.deleteitem` | 管理者 | | `/eshop addhanditem <section> <buy price> <sell price>` | 手に持っているアイテムをショップセクションに追加します。 | `EconomyShopGUI.eshop.addhanditem` | 管理者 | | `/eshop installLayout <id>` | id でショップレイアウトをインストールします（レイアウトマーケットプレイス連携）。 | `EconomyShopGUI.eshop.installLayout` | 管理者 | | `/eshop logs export` | 取引ログを Web 表示としてエクスポートします（取引ログ機能）。 | `未指定` | 管理者 | | `/sellall` | 設定済みのショップセクションに従って、売却可能なアイテムをすべて売却します。 | `EconomyShopGUI.sellall` | プレイヤー | | `/sellgui` | Sell GUI を開いて、メニューからアイテムを売却します。 | `EconomyShopGUI.sellgui` | プレイヤー | （上記のコマンドは、プラグイン作者によって文書化されている場合のみ掲載しています。） ## 🔐 権限 | **権限** | **説明** | **デフォルト** | |---|---|---| | `EconomyShopGUI.shop` | プレイヤーがショップを開けるようにします。 | 未指定 | | `EconomyShopGUI.shop.<section>` | 名前で特定のショップセクションを開けるようにします。 | 未指定 | | `EconomyShopGUI.shop.all` | すべてのショップセクションを開けるようにします。 | 未指定 | | `EconomyShopGUI.sellall` | `/sellall` コマンドの使用を許可します。 | 未指定 | | `EconomyShopGUI.sellall.<section>` | `/sellall` で特定のショップセクションに売却できるようにします。 | 未指定 | | `EconomyShopGUI.sellall.all` | `/sellall` ですべてのセクションに売却できるようにします。 | 未指定 | | `EconomyShopGUI.sellallitem` | `/sellall <item>` の使用を許可します。 | 未指定 | | `EconomyShopGUI.sellgui` | Sell GUI を開けるようにします。 | 未指定 | | `EconomyShopGUI.reload` | プラグインの再読み込みを許可します。 | 未指定 | | `EconomyShopGUI.eshop.additem` | コマンドでショップアイテムを追加できるようにします。 | 未指定 | | `EconomyShopGUI.eshop.edititem` | コマンドでショップアイテムを編集できるようにします。 | 未指定 | | `EconomyShopGUI.eshop.deleteitem` | コマンドでショップアイテムを削除できるようにします。 | 未指定 | | `EconomyShopGUI.eshop.addhanditem` | コマンドで手に持っているアイテムをショップに追加できるようにします。 | 未指定 | | `EconomyShopGUI.eshop.addsection` | コマンドでショップセクションを追加できるようにします。 | 未指定 | | `EconomyShopGUI.eshop.uploadLayout` | レイアウトのアップロードを許可します。 | 未指定 | | `EconomyShopGUI.eshop.installLayout` | レイアウトのインストールを許可します。 | 未指定 | | `EconomyShopGUI.eshop.shopstands.create` | ShopStand アイテムの作成/設置を許可します。 | 未指定 | | `EconomyShopGUI.eshop.shopstands.destroy` | ShopStand の破壊を許可します。 | 未指定 | （プラグインが文書化された権限一覧でデフォルト値を示していない場合、デフォルトは「未指定」として記録されます。） ## ⚙️ インストール ### 📥 セットアップ - 公式のプラグイン JAR をダウンロードし、サーバーの `plugins/` フォルダに配置します。 - サーバーを再起動するか、プラグインマネージャーを使って読み込みます。 - 起動時にサーバーコンソールを確認し、プラグインが読み込まれたことと依存関係の警告がないかを確認します。 ### 📦 依存関係 - 経済プロバイダが必要です。プラグインでは次のいずれかのサポートを案内しています: **Vault**, **PlayerPoints**, **CoinsEngine**, **GemsEconomy**, **UltraEconomy**, **VotingPlugin**, **zEssentials**（経済操作にはこのうち1つが必要です）。 - 任意の統合には PlaceholderAPI、Citizens、Quests、そして直接対応用のさまざまな spawner プラグインが含まれます。 ## 🧠 技術メモ - このプラグインは Bukkit/Spigot/Paper サーバー向けに公開されており、作者は mod 版/ハイブリッドサーバーはサポートしないと述べています。 - 作者が示す要件: Minecraft 1.8+ と Java 8 以上。 - 他のプラグインがショップのイベントや機能にフックできるよう、開発者向け API を公開しています。 - 匿名メトリクス収集に bStats を使用しています。 - GUI エディタ、コマンドアイテム、カスタム NBT アイテムなどを追加する有料版があります。コア機能（GUI ショップ）は無料版にもあります。 ## 🤝 このプラグインが役立つ場面 既存の経済プラグインと連携し、設定可能なレイアウト、ショップセクション、売却フローをサポートするゲーム内のグラフィカルな店舗が必要なら、EconomyShopGUI は管理者向けの文書化されたインターフェースとプラグイン統合用 API を提供します。

プラグイン