Minecraftプラグイン Shopkeepers

🔌 Shopkeepers について

Shopkeepers は Bukkit/Spigot 向けの Minecraft プラグインで、サーバー管理者がカスタマイズ可能な村人商人を配置し、設定したアイテムを設定した価格で販売できるようにします。このプラグインは、管理者ショップ（在庫無制限）と、コンテナから在庫を引き出すプレイヤーショップの両方に対応しており、アドオン連携や拡張のための ShopkeepersAPI も公開しています。

🎯 目的

このプラグインは、ゲーム内の NPC ベースのショップシステムを提供し、手動のチェスト管理や複雑なコマンド式ショップなしで、サーバーに永続的なショップを用意できるようにします。サーバー経済、ロールプレイ用ショップ、NPC 商人を必要とする survival/SMP サーバーに適しています。 ()

⚙️ 特徴

• 取引内容と価格を指定したカスタム村人商人を作成できます。
• 在庫無制限の管理者ショップ。
• 接続されたコンテナ（チェスト）からアイテムを在庫として取得するプレイヤーショップ。
• プラグイン作者が商人をプログラムで取得・管理できる ShopkeepersAPI。
• ゲーム内でのアイテム/アイテムデータのカスタマイズと、プロジェクトの wiki および言語ファイルによる言語ファイル対応。 ()

🧩 対象ユーザー

• NPC が運営するショップを求める Survival / SMP サーバー。
• 村人 NPC を商人として使うロールプレイや経済系サーバー。
• ショップの挙動を他システムへ統合するための API を必要とするプラグイン開発者。 ()

🏗️ 使用例

• 管理者が、サーバー提供の品を販売する無制限の管理者ショップを作成する。
• プレイヤーが、連携したチェスト内のアイテムを自動販売するショップを開く。
• 開発者が、ShopkeepersAPI を使って商人を一覧表示したり変更したりするアドオンを作る。 ()

⌨️ コマンド

(注: 上記には、公式ソースで明示的に文書化されているコマンドのみを掲載しています。) ()

⚙️ インストール

📥 セットアップ

• 公式のプラグイン jar をダウンロードし、サーバーの plugins/ フォルダに配置します。
• サーバーを再起動し、コンソールでプラグインが読み込まれたことを確認します。

(これは Bukkit/Spigot プラグインの標準的なインストール手順であり、プロジェクトのドキュメントでもサポートされています。) ()

🧠 技術メモ

• Shopkeepers は GPL-3.0 ライセンスで公開されており、プロジェクトのリポジトリには API モジュール（ShopkeepersAPI）とビルド手順が含まれています。 ()
• このプロジェクトは、アドオン開発者向けに Maven アーティファクトと公開 API を提供しており、README にはリポジトリの使用方法と API の依存関係座標が記載されています。 ()
• 公式配布とコミュニティサポートは、Spigot のリソースページとこのプラグインの Discord サーバーから利用できます。 ()

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

管理者運営とプレイヤー運営の両方のショップをサポートする、永続的で設定可能な NPC 商人が必要で、さらに他のプラグインへショップを統合するための API が欲しいなら、Shopkeepers は Bukkit/Spigot サーバー向けの実績ある実装を提供します。 ()