マイクラ 経済プラグイン ShopGUI+ 入門
Vault連携&アイテム価格yml設定完全マスター
この記事で学べること
- ShopGUI+プラグインの基本概念と導入方法
- Vault連携による経済システムの構築
- アイテム価格ymlファイルの詳細設定
- player-shops機能の活用法
- トラブルシューティングと最適化
ShopGUI+とは
ShopGUI+の概要
ShopGUI+は、マインクラフトサーバーに高度な経済システムを導入するプラグインです。プレイヤーが簡単にアイテムの売買を行えるGUIベースのショップシステムを提供し、サーバー管理者は詳細な価格設定や商品管理が可能です。
直感的なGUI
チェストのような分かりやすいインターフェースで、プレイヤーは簡単にアイテムを売買できます。
カスタマイズ性
yml形式の設定ファイルで、アイテムの価格、カテゴリ、表示順序などを自由に設定できます。
Vault連携
Vaultプラグインとの連携により、他の経済プラグインとの互換性を確保します。
プレイヤーショップ
プレイヤー同士でアイテムを売買できるプレイヤーショップ機能も利用できます。
前提条件と依存関係
1必要なプラグイン
プラグイン名 | 必須レベル | 役割 | ダウンロード |
---|---|---|---|
Vault | 必須 | 経済システムの基盤 | SpigotMC |
EssentialsX | 必須 | お金の管理システム | 公式サイト |
PlaceholderAPI | 推奨 | 動的な情報表示 | SpigotMC |
WorldGuard | オプション | 地域制限機能 | Bukkit |
2サーバー要件
最小要件
- Java 8以上
- Spigot/Paper 1.16+
- メモリ: 1GB以上
- プレイヤー数: 10人以下
推奨要件
- Java 17以上
- Paper 1.19+
- メモリ: 4GB以上
- プレイヤー数: 50人以上
インストール手順
1基本プラグインのインストール
./stop.sh
# pluginsディレクトリに移動
cd plugins/
# 必要なプラグインをダウンロード
wget https://github.com/EssentialsX/Essentials/releases/download/2.20.1/EssentialsX-2.20.1.jar
wget https://dev.bukkit.org/projects/vault/files/latest/download -O Vault.jar
wget https://github.com/PlaceholderAPI/PlaceholderAPI/releases/download/2.11.3/PlaceholderAPI-2.11.3.jar
2
ShopGUI+のインストール
wget https://www.spigotmc.org/resources/shopgui-1-8-1-20-4.6515/download -O ShopGUI+.jar
# サーバーを起動
./start.sh
初回起動時の確認事項
- 全てのプラグインが正常にロードされているか
- エラーメッセージが出力されていないか
- /plugins コマンドでプラグインが認識されているか
Vault連携設定
1
Vault設定の確認
/vault-info
# 経済プラグインの確認
/balance
# ShopGUI+の設定確認
/shopgui admin
economy:
# 使用する経済プラグイン (vault/playerpoints/coinsengine)
type: vault
# Vault設定
vault:
# 通貨の単位
currency-symbol: “¥”
# 通貨の名前
currency-name: “円”
# 小数点以下の桁数
decimal-places: 0
# 税金設定
tax:
enabled: true
rate: 0.05 # 5%の税率
# 最小/最大取引金額
limits:
min-transaction: 1
max-transaction: 1000000
2EssentialsXとの連携
EssentialsXの経済設定
plugins/Essentials/config.yml を編集して、経済システムを有効化します。
economy-enabled: true
economy-startup-message: true
economy-currency-symbol: “¥”
economy-default-balance: 1000
# 起動時の初期資金
starting-balance: 1000
# 通貨の単位設定
currency:
symbol: “¥”
name-singular: “円”
name-plural: “円”
3動作確認
正常な場合
Economy: EssentialsX Economy
> /balance
残高: ¥1,000
> /shop
ショップGUIが開く
エラーの場合
Economy: None
> /balance
コマンドが認識されない
> /shop
「経済プラグインが見つかりません」
アイテム価格yml設定
1
基本的なyml構造
shop-name: “ブロック”
shop-icon: “STONE”
shop-size: 54
items:
# アイテム1: 石
“1”:
material: “STONE”
quantity: 1
buy-price: 10 # 購入価格
sell-price: 5 # 売却価格
display-name: “石”
lore:
– “基本的な建築ブロック”
– “購入: ¥10”
– “売却: ¥5”
# アイテム2: 丸石
“2”:
material: “COBBLESTONE”
quantity: 1
buy-price: 8
sell-price: 4
display-name: “丸石”
lore:
– “採掘で得られる基本ブロック”
– “購入: ¥8”
– “売却: ¥4”
2カテゴリ別設定例
tools.yml – ツールカテゴリ
shop-icon: “DIAMOND_PICKAXE”
shop-size: 45
items:
“1”:
material: “WOODEN_PICKAXE”
quantity: 1
buy-price: 50
sell-price: 25
display-name: “木のツルハシ”
“2”:
material: “STONE_PICKAXE”
quantity: 1
buy-price: 100
sell-price: 50
display-name: “石のツルハシ”
food.yml – 食料カテゴリ
shop-icon: “BREAD”
shop-size: 36
items:
“1”:
material: “BREAD”
quantity: 1
buy-price: 20
sell-price: 10
display-name: “パン”
“2”:
material: “COOKED_BEEF”
quantity: 1
buy-price: 30
sell-price: 15
display-name: “焼き牛肉”
3
高度な設定オプション
items:
“1”:
material: “DIAMOND”
quantity: 1
buy-price: 1000
sell-price: 500
# 購入制限
buy-limit:
enabled: true
limit: 10 # 1日10個まで
reset-time: 86400 # 24時間後にリセット
# 売却制限
sell-limit:
enabled: true
limit: 5
reset-time: 86400
# 権限制限
permission:
buy: “shop.buy.diamond”
sell: “shop.sell.diamond”
# 動的価格 (需要と供給に基づく)
dynamic-pricing:
enabled: true
min-price: 800
max-price: 1200
demand-multiplier: 1.1
supply-multiplier: 0.9
player-shops機能
1プレイヤーショップの有効化
player-shops:
enabled: true
# ショップ作成制限
creation:
max-shops-per-player: 3
cost-to-create: 1000
required-permission: “shopgui.playershop.create”
# ショップのサイズ
shop-size: 54
# 手数料設定
fees:
enabled: true
rate: 0.05 # 5%の手数料
# 期限設定
expiration:
enabled: true
days: 30 # 30日後に期限切れ
# 広告機能
advertising:
enabled: true
cost-per-day: 100
max-days: 7
2プレイヤーショップの使用方法
ショップの作成
/pshop create <名前>
/pshop seticon <アイテム>
/pshop additem <価格>
/pshop open
ショップの管理
/pshop edit
/pshop delete
/pshop stats
/pshop promote
3ショップブラウザの設定
player-shops-browser:
title: “プレイヤーショップ”
size: 54
# 検索機能
search:
enabled: true
placeholder: “アイテム名で検索…”
# ソート機能
sorting:
options:
– “newest” # 新着順
– “oldest” # 古い順
– “popular” # 人気順
– “price-low” # 安い順
– “price-high” # 高い順
# フィルター機能
filters:
category: true
price-range: true
player-name: true
availability: true
高度な設定
1多言語対応
messages:
shop-opened: “ショップを開きました”
item-purchased: “%item% を %amount% 個購入しました (-%price%円)”
item-sold: “%item% を %amount% 個売却しました (+%price%円)”
insufficient-funds: “資金が不足しています”
insufficient-space: “インベントリに空きがありません”
gui:
buy-button: “購入”
sell-button: “売却”
back-button: “戻る”
close-button: “閉じる”
# カテゴリ名
categories:
blocks: “ブロック”
tools: “ツール”
food: “食料”
combat: “戦闘”
misc: “その他”
2権限システム
権限 | 説明 | デフォルト |
---|---|---|
shopgui.use |
ショップの使用 | true |
shopgui.buy |
アイテムの購入 | true |
shopgui.sell |
アイテムの売却 | true |
shopgui.admin |
管理者権限 | op |
shopgui.playershop.create |
プレイヤーショップの作成 | true |
3データベース連携
database:
# データベースの種類 (sqlite/mysql/postgresql)
type: mysql
# MySQL設定
mysql:
host: localhost
port: 3306
database: minecraft_shop
username: shopgui
password: your_password
# 接続プール設定
connection-pool:
maximum-pool-size: 10
minimum-idle: 5
connection-timeout: 30000
# データ同期設定
sync:
enabled: true
interval: 300 # 5分間隔
# バックアップ設定
backup:
enabled: true
interval: 86400 # 24時間間隔
keep-backups: 7 # 7日分保持
トラブルシューティング
よくある問題と解決方法
原因: Vaultプラグインが正しく設定されていない
解決方法:
- /vault-info コマンドで経済プラグインを確認
- EssentialsXの経済機能が有効化されているか確認
- サーバーを再起動してプラグインを再読み込み
原因: ymlファイルの構文エラー
解決方法:
- ymlファイルのインデントを確認(スペースのみ使用)
- オンラインのymlバリデーターでチェック
- /shopgui reload コマンドで設定を再読み込み
原因: 権限の設定問題
解決方法:
- 権限プラグインで shopgui.playershop.create を付与
- 作成に必要な資金が足りているか確認
- 最大作成数に達していないか確認
原因: データベース接続エラー
解決方法:
- データベースの接続設定を確認
- ファイルの書き込み権限を確認
- ログファイルでエラーメッセージを確認
デバッグ機能
/shopgui debug on
# 特定のプレイヤーのデバッグ
/shopgui debug player <プレイヤー名>
# 取引ログの確認
/shopgui log transactions
# データベースの整合性チェック
/shopgui check database
パフォーマンス最適化
1メモリ使用量の最適化
performance:
# キャッシュ設定
cache:
enabled: true
size: 1000
expire-time: 300 # 5分
# 非同期処理
async:
enabled: true
thread-pool-size: 4
# データベース最適化
database:
batch-size: 100
connection-timeout: 30
# GUI最適化
gui:
lazy-loading: true
item-cache: true
refresh-interval: 30
2データベース最適化
インデックス設定
CREATE INDEX idx_item_id ON transactions(item_id);
CREATE INDEX idx_timestamp ON transactions(timestamp);
データクリーンアップ
DELETE FROM player_shops WHERE expired = 1;
3監視とメトリクス
/shopgui metrics
# 出力例:
# =============================================
# ShopGUI+ Performance Metrics
# =============================================
# Active transactions: 42
# Cache hit rate: 87.3%
# Database queries/sec: 15.2
# Memory usage: 45.7 MB
# Thread pool size: 4/4
# Average response time: 12ms
# =============================================
おすすめのMinecraftサーバー
ShopGUI+に最適化されたサーバー比較
XServer VPS for Game
- CPU: 3コア、メモリ: 2GB
- SSD: 50GB、転送量: 無制限
- マイクラ特化の管理パネル
- 自動バックアップ機能
- 24時間サポート
ConoHa for GAME
- CPU: 2コア、メモリ: 1GB
- SSD: 100GB、転送量: 無制限
- マイクラテンプレート対応
- 簡単スケールアップ
- 時間課金対応
LOLIPOP! for Gamers
- CPU: 2コア、メモリ: 1GB
- SSD: 50GB、転送量: 5TB
- ゲーム特化設定
- 簡単インストール
- コストパフォーマンス重視
さくら VPS
- CPU: 1コア、メモリ: 512MB
- SSD: 25GB、転送量: 無制限
- 老舗の安定性
- 豊富な管理機能
- 拡張性重視
サーバー選びのポイント
- メモリ: 最低2GB以上(プレイヤー20人以上の場合は4GB推奨)
- CPU: マルチコア対応(データベース処理のため)
- ストレージ: SSD推奨(データベースの高速化)
- ネットワーク: 安定した回線(取引の遅延防止)
- バックアップ: 自動バックアップ機能(データ保護)
まとめ
ShopGUI+は、マインクラフトサーバーに本格的な経済システムを導入できる強力なプラグインです。Vault連携により他のプラグインとの互換性を保ち、豊富な設定オプションでサーバーの特色に合わせたカスタマイズが可能です。
✅ 習得したスキル
- ShopGUI+の基本設定
- Vault連携の構築
- yml価格設定
- プレイヤーショップ運用
🚀 次のステップ
- 動的価格システムの導入
- 高度な権限管理
- データベース最適化
- 監視システムの構築
※本記事は2025年7月時点の情報に基づいて執筆されています。内容の正確性には万全を期していますが、最新情報は各公式サイトをご確認ください。プラグインの導入や設定変更は自己責任で行い、必ず事前にバックアップを取ってください。