Minecraftサーバー Shopkeepers プラグイン

## 🔌 Shopkeepers について Shopkeepers は Bukkit/Spigot 向けの Minecraft プラグインで、サーバー管理者がカスタマイズ可能な村人商人を配置し、設定したアイテムを設定した価格で販売できるようにします。このプラグインは、管理者ショップ（在庫無制限）と、コンテナから在庫を引き出すプレイヤーショップの両方に対応しており、アドオン連携や拡張のための ShopkeepersAPI も公開しています。 ## 🎯 目的 このプラグインは、ゲーム内の NPC ベースのショップシステムを提供し、手動のチェスト管理や複雑なコマンド式ショップなしで、サーバーに永続的なショップを用意できるようにします。サーバー経済、ロールプレイ用ショップ、NPC 商人を必要とする survival/SMP サーバーに適しています。 () ## ⚙️ 特徴 - 取引内容と価格を指定したカスタム村人商人を作成できます。 - 在庫無制限の管理者ショップ。 - 接続されたコンテナ（チェスト）からアイテムを在庫として取得するプレイヤーショップ。 - プラグイン作者が商人をプログラムで取得・管理できる ShopkeepersAPI。 - ゲーム内でのアイテム/アイテムデータのカスタマイズと、プロジェクトの wiki および言語ファイルによる言語ファイル対応。 () ## 🧩 対象ユーザー - NPC が運営するショップを求める Survival / SMP サーバー。 - 村人 NPC を商人として使うロールプレイや経済系サーバー。 - ショップの挙動を他システムへ統合するための API を必要とするプラグイン開発者。 () ## 🏗️ 使用例 - 管理者が、サーバー提供の品を販売する無制限の管理者ショップを作成する。 - プレイヤーが、連携したチェスト内のアイテムを自動販売するショップを開く。 - 開発者が、ShopkeepersAPI を使って商人を一覧表示したり変更したりするアドオンを作る。 () ## ⌨️ コマンド | **Command** | **Description** | **Permission** | **Access** | |---|---|---|---| | `/shopkeeper history [player|'all'|'self'] [shop=...|owner=...|'own'|'player'|'admin'|'all'] [page]` | フィルター付きで取引/履歴一覧を表示します（構文は公式ドキュメントで確認済み）。 | 指定なし | Admin | (注: 上記には、公式ソースで明示的に文書化されているコマンドのみを掲載しています。) () ## ⚙️ インストール ### 📥 セットアップ - 公式のプラグイン jar をダウンロードし、サーバーの `plugins/` フォルダに配置します。 - サーバーを再起動し、コンソールでプラグインが読み込まれたことを確認します。 (これは Bukkit/Spigot プラグインの標準的なインストール手順であり、プロジェクトのドキュメントでもサポートされています。) () ## 🧠 技術メモ - Shopkeepers は GPL-3.0 ライセンスで公開されており、プロジェクトのリポジトリには API モジュール（ShopkeepersAPI）とビルド手順が含まれています。 () - このプロジェクトは、アドオン開発者向けに Maven アーティファクトと公開 API を提供しており、README にはリポジトリの使用方法と API の依存関係座標が記載されています。 () - 公式配布とコミュニティサポートは、Spigot のリソースページとこのプラグインの Discord サーバーから利用できます。 () ## 🤝 このプラグインが役立つ場面 管理者運営とプレイヤー運営の両方のショップをサポートする、永続的で設定可能な NPC 商人が必要で、さらに他のプラグインへショップを統合するための API が欲しいなら、Shopkeepers は Bukkit/Spigot サーバー向けの実績ある実装を提供します。 ()

プラグイン