マイクラ 経済プラグイン ShopGUI+ 入門:Vault連携&アイテム価格yml設定完全マスター

マイクラ 経済プラグイン ShopGUI+ 入門:Vault連携&アイテム価格yml設定完全マスター






マイクラ 経済プラグイン ShopGUI+ 入門:Vault連携&アイテム価格yml設定完全マスター


マイクラ 経済プラグイン ShopGUI+ 入門

Vault連携&アイテム価格yml設定完全マスター

2025年7月最新情報

この記事で学べること

  • ShopGUI+プラグインの基本概念と導入方法
  • Vault連携による経済システムの構築
  • アイテム価格ymlファイルの詳細設定
  • player-shops機能の活用法
  • トラブルシューティングと最適化

目次

ShopGUI+とは

ShopGUI+の概要

ShopGUI+は、マインクラフトサーバーに高度な経済システムを導入するプラグインです。プレイヤーが簡単にアイテムの売買を行えるGUIベースのショップシステムを提供し、サーバー管理者は詳細な価格設定や商品管理が可能です。

直感的なGUI

チェストのような分かりやすいインターフェースで、プレイヤーは簡単にアイテムを売買できます。

カスタマイズ性

yml形式の設定ファイルで、アイテムの価格、カテゴリ、表示順序などを自由に設定できます。

Vault連携

Vaultプラグインとの連携により、他の経済プラグインとの互換性を確保します。

プレイヤーショップ

プレイヤー同士でアイテムを売買できるプレイヤーショップ機能も利用できます。

前提条件と依存関係

1必要なプラグイン

重要: ShopGUI+を正常に動作させるためには、以下のプラグインが必要です。
プラグイン名 必須レベル 役割 ダウンロード
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+のインストール

# 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の状態を確認
/vault-info

# 経済プラグインの確認
/balance

# ShopGUI+の設定確認
/shopgui admin

# plugins/ShopGUI+/config.yml
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 を編集して、経済システムを有効化します。

# 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動作確認

正常な場合

> /vault-info
Economy: EssentialsX Economy
> /balance
残高: ¥1,000
> /shop
ショップGUIが開く

エラーの場合

> /vault-info
Economy: None
> /balance
コマンドが認識されない
> /shop
「経済プラグインが見つかりません」

アイテム価格yml設定

1
基本的なyml構造

# plugins/ShopGUI+/shops/blocks.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-name: “ツール”
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-name: “食料”
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

注意: ymlファイルを編集する際は、インデント(空白)に注意してください。Tabキーではなく、スペースキーを使用してください。

player-shops機能

1プレイヤーショップの有効化

# plugins/ShopGUI+/config.yml
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ショップブラウザの設定

# ショップブラウザのGUI設定
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多言語対応

# plugins/ShopGUI+/lang/ja_JP.yml
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データベース連携

# plugins/ShopGUI+/config.yml
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日分保持

トラブルシューティング

よくある問題と解決方法

Q: ショップが開かない

原因: Vaultプラグインが正しく設定されていない

解決方法:

  1. /vault-info コマンドで経済プラグインを確認
  2. EssentialsXの経済機能が有効化されているか確認
  3. サーバーを再起動してプラグインを再読み込み

Q: アイテムの価格が反映されない

原因: ymlファイルの構文エラー

解決方法:

  1. ymlファイルのインデントを確認(スペースのみ使用)
  2. オンラインのymlバリデーターでチェック
  3. /shopgui reload コマンドで設定を再読み込み

Q: プレイヤーショップが作成できない

原因: 権限の設定問題

解決方法:

  1. 権限プラグインで shopgui.playershop.create を付与
  2. 作成に必要な資金が足りているか確認
  3. 最大作成数に達していないか確認

Q: 取引履歴が保存されない

原因: データベース接続エラー

解決方法:

  1. データベースの接続設定を確認
  2. ファイルの書き込み権限を確認
  3. ログファイルでエラーメッセージを確認

デバッグ機能

# デバッグモードの有効化
/shopgui debug on

# 特定のプレイヤーのデバッグ
/shopgui debug player <プレイヤー名>

# 取引ログの確認
/shopgui log transactions

# データベースの整合性チェック
/shopgui check database

パフォーマンス最適化

1メモリ使用量の最適化

# plugins/ShopGUI+/config.yml
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_player_uuid ON transactions(player_uuid);
CREATE INDEX idx_item_id ON transactions(item_id);
CREATE INDEX idx_timestamp ON transactions(timestamp);

データクリーンアップ

DELETE FROM transactions WHERE timestamp < DATE_SUB(NOW(), INTERVAL 30 DAY);
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

月額830円〜
  • CPU: 3コア、メモリ: 2GB
  • SSD: 50GB、転送量: 無制限
  • マイクラ特化の管理パネル
  • 自動バックアップ機能
  • 24時間サポート
ShopGUI+推奨ポイント: 高性能CPU、安定したメモリ、データベース最適化

詳細を見る

ConoHa for GAME

月額751円〜
  • CPU: 2コア、メモリ: 1GB
  • SSD: 100GB、転送量: 無制限
  • マイクラテンプレート対応
  • 簡単スケールアップ
  • 時間課金対応
ShopGUI+推奨ポイント: 柔軟な料金体系、高速SSD、簡単操作

詳細を見る

LOLIPOP! for Gamers

月額550円〜
  • CPU: 2コア、メモリ: 1GB
  • SSD: 50GB、転送量: 5TB
  • ゲーム特化設定
  • 簡単インストール
  • コストパフォーマンス重視
ShopGUI+推奨ポイント: 初心者向け、低コスト、安定運用

詳細を見る

さくら VPS

月額590円〜
  • CPU: 1コア、メモリ: 512MB
  • SSD: 25GB、転送量: 無制限
  • 老舗の安定性
  • 豊富な管理機能
  • 拡張性重視
ShopGUI+推奨ポイント: 信頼性、カスタマイズ性、長期運用

詳細を見る

サーバー選びのポイント

  • メモリ: 最低2GB以上(プレイヤー20人以上の場合は4GB推奨)
  • CPU: マルチコア対応(データベース処理のため)
  • ストレージ: SSD推奨(データベースの高速化)
  • ネットワーク: 安定した回線(取引の遅延防止)
  • バックアップ: 自動バックアップ機能(データ保護)

まとめ

ShopGUI+は、マインクラフトサーバーに本格的な経済システムを導入できる強力なプラグインです。Vault連携により他のプラグインとの互換性を保ち、豊富な設定オプションでサーバーの特色に合わせたカスタマイズが可能です。

✅ 習得したスキル

  • ShopGUI+の基本設定
  • Vault連携の構築
  • yml価格設定
  • プレイヤーショップ運用

🚀 次のステップ

  • 動的価格システムの導入
  • 高度な権限管理
  • データベース最適化
  • 監視システムの構築

※本記事は2025年7月時点の情報に基づいて執筆されています。内容の正確性には万全を期していますが、最新情報は各公式サイトをご確認ください。プラグインの導入や設定変更は自己責任で行い、必ず事前にバックアップを取ってください。


目次