ChestShop完全ガイド
経済ショップ作成とAdminShop設定【2025年7月最新】
最終更新：2025年7月
ChestShopとは
ChestShopは、マインクラフトサーバーでチェストと看板を使った自動ショップシステムを実現する人気プラグインです。プレイヤー同士の安全な取引を可能にし、経済サーバー運営の基盤となります。
2025年7月最新版の主な特徴
- チェスト、樽、シュルカーボックス対応
- ホログラム表示機能の搭載
- Discord連携機能
- MMOItems連携対応
- 詳細な課税システム
- 包括的なログ記録機能
メリット
- 24時間自動販売
- 安全な取引システム
- 豊富なカスタマイズ性
- 直感的な操作方法
必要な依存関係
- Vault 1.7.3+
- 経済プラグイン（EssentialsX推奨）
- NBT-API 2.15.0+
導入方法
導入前の注意点
ChestShopを使用するには、経済プラグインの導入が必須です。まずVaultとEssentialsXなどの経済プラグインを導入してください。
ステップ 1
依存プラグインのダウンロード
Vault
NBT-API
ステップ 2
ChestShopのダウンロード
最新版（2025年7月6日リリース）をダウンロード：
ステップ 3
プラグインの設置
- ダウンロードした.jarファイルをサーバーの
pluginsフォルダに配置 - サーバーを再起動
- 設定ファイル（config.yml）が自動生成されることを確認
看板フォーマット設定
基本的な看板フォーマット
従来の看板作成方法
設定例：
新コマンド方式（推奨）
使用例：
価格設定のルール
| 設定値 | 動作 | 例 |
|---|---|---|
| B100:S50 | 購入100、売却50 | 両方の取引が可能 |
| B100 | 購入のみ100 | プレイヤーが購入のみ可能 |
| S50 | 売却のみ50 | プレイヤーが売却のみ可能 |
| B0:S50 | 購入無効、売却50 | 買取専用ショップ |
AdminShop設定
AdminShopとは
AdminShopは無限の在庫とお金を持つ管理者専用ショップです。サーバー経済の基盤となる重要なアイテムの安定供給に使用されます。
作成方法
コマンド方式（推奨）
手にアイテムを持ってコマンド実行
看板方式
設定項目
ADMIN_SHOP_NAME
管理者ショップの看板1行目表示名
FORCE_UNLIMITED_ADMIN_SHOP
全ての管理者ショップを無限在庫にする
権限設定
| 権限 | 説明 | デフォルト |
|---|---|---|
| chestshop.admin | AdminShop作成権限 | OP |
| chestshop.unlimited | 無限在庫ショップ作成 | false |
| chestshop.remove | ショップ削除権限 | true |
課税システム
課税システムとは
ChestShopの取引から一定割合をサーバー口座に自動徴収する機能です。経済バランスの調整やインフレ抑制に効果的です。
課税設定項目
TAX_AMOUNT
一般ショップからの課税率（％）
SERVER_TAX_AMOUNT
AdminShopからの課税率（％）
サーバー口座設定
SERVER_ECONOMY_ACCOUNT
課税収入が入るアカウント名
SERVER_ECONOMY_ACCOUNT_UUID
サーバー口座のUUID
課税計算例
プレイヤーショップでの取引
AdminShopでの取引
ログ記録機能
ログ記録の重要性
取引履歴の記録は、不正行為の検出、経済分析、トラブル解決に不可欠です。ChestShopは包括的なログ機能を提供しています。
基本ログ設定
LOG_TO_FILE
ファイルへのログ出力
LOG_TO_CONSOLE
コンソールへのログ出力
詳細ログ設定
LOG_ALL_SHOP_REMOVALS
ショップ削除のログ記録
DEBUG
デバッグ情報の記録
Discord連携ログ
2025年版ChestShopでは、Discordへのリアルタイム通知機能が搭載されています。
# Discord連携設定
discord:
enabled: true
transaction-enabled: true
webhook-url: "https://discord.com/api/webhooks/xxx/yyy"
webhook-name: "ChestShop"
timezone: "Asia/Tokyo"ログ出力例
取引成功ログ
エラーログ
推奨サーバーホスティング
ChestShopを快適に動作させるための推奨サーバーをご紹介します。経済プラグインは処理負荷が高いため、高性能なサーバーの選択が重要です。
サーバー選びのポイント
- メモリ容量：経済プラグイン使用時は最低4GB、推奨8GB以上
- CPU性能：取引処理が頻繁なため、高クロック数を重視
- ストレージ：ログファイル蓄積のため、SSD推奨
- バックアップ：経済データ保護のため、自動バックアップ機能必須
よくある質問（FAQ）
ショップが動作しません。何を確認すべきですか？
以下の項目を順番に確認してください：
- VaultとEssentialsX（経済プラグイン）が正常に動作しているか
- NBT-APIプラグインがインストールされているか
- チェストの中に十分なアイテムまたは資金があるか
- 看板のフォーマットが正しいか
- 必要な権限が付与されているか
AdminShopとプレイヤーショップの違いは何ですか？
AdminShop
- 無限の在庫とお金
- 管理者のみ作成可能
- サーバー経済の基盤
プレイヤーショップ
- チェストの在庫に依存
- 全プレイヤー作成可能
- プレイヤー間取引
課税システムを無効にできますか？
はい、config.ymlで以下のように設定すると課税を無効にできます：
SERVER_TAX_AMOUNT: 0
ホログラム表示が文字化けします。
日本語表示の問題は、サーバーのエンコーディング設定が原因の可能性があります。server.propertiesファイルでUTF-8エンコーディングが有効になっているか確認してください。