ChestShop完全ガイド
最終更新：2026年1月
ChestShopは、チェスト（などのコンテナ）＋看板でプレイヤー間取引を実現する定番プラグインです。
本記事は、SpigotMCで広く使われているChestShop-3（リソースID: 51856）を前提に、2026年1月時点で破綻している情報（依存関係／コマンド／機能の誤認など）を修正し、
WordPressにそのまま貼り付けられるHTMLに整形しています。
ChestShopとは
ChestShopは、看板をクリックするだけで購入（右クリック）／売却（左クリック）ができるショップ機能を提供します。
経済連携はVault経由で行うため、EssentialsXなどのエコノミープラグインと組み合わせて使うのが一般的です。
2025年7月最新版の主な特徴
見出しは元記事のままですが、内容は2026年1月時点の実態に合わせて更新しています。
なお、ChestShopは安定版リリースが古い場合でも、SpigotMC公式ページから開発ビルド（development build）が提供されており、
新しめのMinecraftバージョンでは開発ビルド利用が推奨されるケースがあります。
- 看板クリックで売買（右クリックで購入／左クリックで売却。設定で変更可能）
- 対応コンテナは設定で拡張（例：BARREL、SHULKER_BOX 等を許可リストに追加）
- AdminShop（無限在庫・サーバー口座運用）
- 課税（TAX_AMOUNT / SERVER_TAX_AMOUNT 等）
- 取引ログ（ChestShop.log への記録）
- 拡張モジュール/アドオン（例：Addaでアイテム表示・Discordアラート等）
メリット
- 24時間自動販売・自動買取ができる
- コマンド不要で直感的（看板設置＋クリック）
- AdminShopや課税、ログでサーバー経済を運用しやすい
- 設定で対応コンテナや挙動を調整できる
必要な依存関係
- Vault（必須）
SpigotMC公式ページ（Vault） - 経済プラグイン（必須）
例：EssentialsX など（Vault対応のEconomy実装が必要）
※元記事で挙がっていたNBT-APIは、ChestShop-3の必須依存としては一般的ではありません。
ただし、サーバー構成（アドオンや別プラグイン併用）によっては必要になる場合があります。
導入方法
導入前の注意点
- Paper / Purpur 等の派生サーバーで運用すると、互換性やパフォーマンス面で有利なことがあります（環境次第）。
- 新しめのMinecraftバージョンでは、安定版より開発ビルドの方が動作が安定するケースがあります（公式ページに開発ビルドリンクあり）。
ステップ 1
依存プラグインのダウンロード
- Vault をダウンロードし、plugins フォルダに配置
- EssentialsX などの経済プラグインを導入（VaultがEconomyを認識できる状態にする）
ステップ 2
ChestShopのダウンロード
ChestShop（ChestShop-3）はSpigotMC配布ページから入手します。
SpigotMC公式ページ（ChestShop）
※最新Minecraftで動かす場合、配布ページ内のdevelopment buildリンクを利用するのが無難なケースがあります（配布ページに案内があります）。
ステップ 3
プラグインの設置
- Vault / 経済プラグイン / ChestShop の .jar を plugins フォルダに配置
- サーバーを起動（または再起動）
- plugins/ChestShop/ 配下に config.yml 等が生成されることを確認
日本語の動画（参考）
- iConomy + ChestShop（日本語解説・旧構成の参考として）
- ChestShopの実運用例（日本語）
看板フォーマット設定
ChestShopの基本は看板方式です。看板テキストが条件を満たすとショップになります。
基本的な看板フォーマット
従来の看板作成方法
看板の各行（例）：
（1行目）空欄（自動で所有者名が入る）
（2行目）数量
（3行目）価格（B=販売価格 / S=買取価格）
（4行目）アイテム名（例：DIAMOND など）例：
(空欄)
64
B 500 : 400 S
DIAMOND
新コマンド方式（推奨）
※重要：ChestShop-3本体には標準で「/shop」や「/adminshop」コマンドでショップ看板を作る機能は一般的ではありません。
元記事の「/shop」「/adminshop」は、別プラグイン／自作スクリプト／サーバー独自コマンドの可能性が高いため、
ここではChestShop本体の標準運用（看板方式）を推奨として扱います。
価格設定のルール
| 設定値 | 動作 | 例 |
|---|---|---|
| B 100 : 50 S | 購入100、売却50（両方） | 購入・買取の両対応 |
| B 100 | 購入のみ100 | プレイヤーは購入のみ可能 |
| S 50 | 売却のみ50 | プレイヤーは売却のみ可能 |
| S free | 無料買取など（設定・実装依存） | サーバー設定で挙動を確認 |
対応コンテナ（樽・シュルカーなど）を増やす場合は、config.yml の SHOP_CONTAINERS に許可するブロックIDを追加します。
例として、BARRELやSHULKER_BOX（各色含む）を許可する運用が案内されています。
AdminShop設定
AdminShopとは
AdminShopは、在庫や所持金を実質無限として扱える管理者ショップの運用です。
サーバーの基準価格（換金所・初期物資・基礎素材の流通）を作るのに向いています。
作成方法
看板方式
AdminShopは、看板1行目をAdminShop名（configで指定）にして作成します（例：初期値が “Admin Shop” の構成が多いです）。
Admin Shop
64
B 100 : 80 S
DIAMOND※実際の1行目文字列は ADMIN_SHOP_NAME に依存します。サーバー側の設定値に合わせてください。
設定項目
ADMIN_SHOP_NAME
管理者ショップの看板1行目表示名
ADMIN_SHOP_NAME: "Admin Shop"FORCE_UNLIMITED_ADMIN_SHOP
全ての管理者ショップを無限在庫にする
FORCE_UNLIMITED_ADMIN_SHOP: true権限設定
権限ノードは環境や配布物で差分が出ることがあります。基本方針としては、
AdminShop作成権限はOP/管理者に限定し、一般ユーザーに与えないのが安全です。
課税システム
課税システムとは
ChestShopは取引金額から一定割合を差し引き、サーバー口座（または指定口座）へ回すような運用ができます。
経済バランス調整やインフレ抑制に使われます。
課税設定項目
TAX_AMOUNT
一般ショップからの課税率（％）
TAX_AMOUNT: 5SERVER_TAX_AMOUNT
AdminShopからの課税率（％）
SERVER_TAX_AMOUNT: 2サーバー口座設定
AdminShopや税金の受け皿として、サーバー口座（Economyアカウント）を指定する構成があります。
SERVER_ECONOMY_ACCOUNT: "servershop"
SERVER_ECONOMY_ACCOUNT_UUID: "00000000-0000-0000-0000-000000000000"課税計算例
- プレイヤーが100で購入（B 100）
- TAX_AMOUNT が 5 の場合：取引額100のうち 5 が税として差し引かれる（配分先は設定・運用に依存）
- 実際の差し引き・入金タイミングは、Vault/Economy実装や設定により差が出るため、テストサーバーで検証してください
ログ記録機能
ログ記録の重要性
取引ログは、不正調査・返金対応・経済監査に必須です。ChestShopは取引ログをファイルに記録でき、
トラブル時の確認材料になります。
基本ログ設定
ログの詳細はバージョンや設定により異なります。まずは標準ログ（ChestShop.log）が出力されることを確認し、
重要サーバーではログローテーションや外部転送（別途ツール）も検討してください。
詳細ログ設定
- 取引頻度が高いサーバーでは、ログ肥大化に注意（ローテーション推奨）
- 管理用途なら、購入者／販売者／アイテム／価格／数量が追える形式で保存されることが重要
Discord連携ログ
ChestShop単体でDiscordへ直接投稿する構成は一般的ではありませんが、拡張として
Adda（ChestShop用アドオン）が「Discord alerts」等を含む機能を案内しています。
もしくは、ログファイルを外部転送してDiscordに通知する仕組み（別ツール／別プラグイン）を組み合わせる運用が現実的です。
- Adda（ChestShop用アドオン）
Modrinth（Addon adda for chestshop）
ログ出力例
例（実際の形式は環境で異なります）：
[日時] buyer=PlayerA seller=PlayerB item=DIAMOND amount=64 price=500 action=BUY推奨サーバーホスティング
ここは元記事の構成を維持し、リンクも保持しています。ChestShopは常時稼働が前提になりやすいので、
24時間稼働のVPS/ゲーム向けホスティングと相性が良いです。