Minecraftプラグイン zAuctionHouse

🔌 zAuctionHouseについて

zAuctionHouse は、プレイヤーがアイテムを出品・閲覧・購入できる、機能充実のオークションハウスを実装する Minecraft プラグインです。設定の柔軟性、GUI ベースのインターフェース、複数の経済タイプへの対応に重点を置いています。プロジェクトは GroupeZ-dev によって保守されており、リポジトリとドキュメントでは、最新の Java とサーバーアーキテクチャを対象とした V4 の再設計が示されています。

🎯 目的

zAuctionHouse は、プレイヤーが即時購入の出品を作成し、まとめ売りを行い、カテゴリ分けされた在庫を閲覧できる中央マーケットプレイスを提供することで、ゲーム内アイテム取引の問題を解決します。管理者の監査と、オプションのネットワーク同期を備えた統合マーケットプレイスを求めるサーバー向けです。

⚙️ 機能

• 即時購入（buy-it-now）出品と、対応している場合の入札形式のワークフロー。
• まとめ売り: 1つの出品で複数アイテムを販売。
• 購入前に内容を確認できる Shulker ボックスのプレビュー。
• 大量の出品に対応するカテゴリフィルタ、高度な並び替え、ページネーション。
• 複数経済への対応（Vault、PlayerPoints、CoinsEngine、アイテムベース通貨、XP/レベル）。
• 設定可能な税システムと、権限ベースの税率軽減。
• 自動受け取りまたは手動受け取りの売上金配送、オフライン販売通知。
• 完全にカスタマイズ可能な GUI とインベントリテンプレートのための zMenu 連携。
• フォーマット済みメッセージとプレースホルダーのための PlaceholderAPI と MiniMessage 対応。
• 管理ツール: 管理パネル、操作ログ、取引履歴、アイテム復元、キャッシュ管理コマンド。
• 分散ロックと pub/sub を備えた Redis アドオンによるマルチサーバー同期。
• ブラックリスト/ホワイトリストによるアイテム制御、ワールド制限、出品・価格の制限、競合状態を防ぐための取引ロック。
• 設定可能な embed 内容で売上通知を送れる Discord webhook 対応。

🧩 対象ユーザー

• プレイヤー主導のマーケットプレイスを求める Survival と SMP サーバー。
• 取引システムが必要な Skyblock、Factions、経済重視のサーバー。
• 複数のバックエンドサーバー間で同期されたマーケットプレイスを必要とするネットワーク。
• 監査ログと管理者向け復元ツールが必要なサーバー管理者。

🏗️ 使用例

• プレイヤーがレアドロップやクラフト品を固定価格で出品し、他のプレイヤーがすぐ購入できるようにする。
• サーバー運営者が権限を使って税ルールや VIP の税率軽減を適用する。
• マルチサーバーネットワークが Redis アドオンを使って hub サーバーと backend サーバー間で出品と販売を同期する。

⌨️ コマンド

（上記のコマンドは、公式プロジェクト документаation とリポジトリのクイックスタート資料に基づいています。）

🔐 権限

（公式の設定とドキュメントで明示的に参照されている権限ノードのみを記載しています。）

⚙️ インストール

📥 セットアップ

• プロジェクトの配布物（公式販売ページまたはカタログ）から公式の zAuctionHouse jar を入手します。
• zAuctionHouse の jar（および必要なプラグイン）をサーバーの plugins/ ディレクトリに配置します。
• サーバーを再起動し、コンソールでプラグインが初期化されることを確認します。
• plugins/zAuctionHouse/config.yml を使ってプラグインを設定し、plugins/zAuctionHouse/inventories/ の GUI インベントリをカスタマイズします。

📦 依存関係

• 必須: zMenu, PlaceholderAPI.
• 任意 / 対応連携: Vault, LuckPerms, およびマルチサーバー同期用の zAuctionHouse Redis アドオン。

🧠 技術メモ

• このプロジェクトは最新の Java を対象としており（V4 の再設計は Java 21 を対象）、アーキテクチャには repository パターン / ORM を使用しています。
• 推奨サーバーソフトウェアには Paper と Paper 系フォークが含まれ、Folia やいくつかの Paper ベースのフォークも対応として挙げられています。
• 公式ドキュメントと配布情報では Minecraft 1.20 から 1.21+ までのサポートが示されています（本番導入前に、正確なビルド互換性をプロジェクトのドキュメントで確認してください）。

❓ FAQ

• 無料版はありますか？
  無料のデモビルドが利用可能です（プロジェクトは一部のプラットフォームで free/demo 版を提供しています）が、完全版でサポート付きのリリースはプロジェクトのプレミアムチャネルを通じて配布されます。

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

設定可能で GUI ベースのマーケットプレイス、複数経済への対応、オプションのマルチサーバー同期が必要なら、zAuctionHouse は管理者監査と zMenu による GUI カスタマイズを備えた、保守されているオークションハウス実装を提供します。