Minecraftプラグイン AuctionHouse

🔌 AuctionHouse について

AuctionHouse は、/ah コマンドでアクセスできるゲーム内オークションハウスを追加する Minecraft プラグインです。プレイヤーはアイテムを出品し、出品を閲覧・検索し、GUI ベースの市場を通してアイテムを購入できます。このプラグインは、設定可能な出品ルール、手数料、告知を備えたプレイヤー間取引に重点を置いています。

🎯 目的

AuctionHouse は、サーバーがプレイヤー運営のショップや看板ベースの市場に頼らず、管理されたオークションシステムを提供できるように、中央集約型の GUI 主導のマーケットプレイスを提供します。検索可能な公開市場と、設定可能な制限および経済連携を求めるサーバー向けです。

⚙️ 機能

• /ah で開く GUI のオークションハウス。
• 出品の作成・キャンセル、キャンセル済みまたは期限切れアイテムの回収。
• 名前、種類、lore、enchants、または出品者で出品を検索・フィルタリング。
• 時間または価格で出品を並べ替え。
• 出品制御: 最低/最高価格、出品手数料（固定および/または割合）、上限付きの出品者税、出品間のクールダウンを設定可能。
• 名前、種類、lore、エンチャント、ダメージ、unbreakable フラグ、custom_model_data、正規表現パターンによるアイテム制限。
• サーバーアイテムの出品オプション（1回限りまたは無制限の出品）。
• 看板、名前付きブロックエンティティ（チェスト、シュルカー、ディスペンサーなど）、またはカスタム名付きエンティティでオークションを開く特殊トリガー。
• ホバー時のツールチップで残り時間と enchants を表示。
• 新規出品の任意アナウンスと Discord 連携。
• 国際化対応、および設定可能なメッセージ、素材、サウンド。
• 取引ログを別ファイルに記録し、放置されたアイテムを自動で整理。

🧩 対象

• 共有プレイヤーマーケットを求める Survival と SMP サーバー。
• 検索可能なオークション GUI を必要とする経済重視のサーバー。
• 設定可能な出品ルール、手数料、アイテム制限が必要な管理者。

🏗️ 使用例

• プレイヤーが余った戦利品を出品し、チェストやショップの代わりにサーバーコミュニティへオークションに出す。
• サーバースタッフが、サーバー提供アイテム向けに制限付きまたは無制限の出品を作成する。
• 管理者が特定のアイテムを制限したり、出品税を適用したりして、サーバー経済のルールを維持する。

⌨️ コマンド

🔐 権限

⚙️ インストール

📥 セットアップ

• 公式のプラグイン .jar をダウンロードし、Spigot 対応サーバーの plugins/ ディレクトリに配置します。
• サーバーを再起動（完全再起動）し、コンソールでプラグインが読み込まれたことを確認します。
• 必要に応じて提供されている設定ファイルでプラグインを構成します。

📦 依存関係

• Vault（必須、1.7.1+ 推奨）。
• 適切な経済プラグイン（例: EssentialsX economy、または Vault 対応の他の経済プロバイダー）。
• 適切な権限プラグイン（デフォルト以外の権限を使う場合）。

🧠 技術メモ

• ストレージ: このプラグインは SQLite を使用します（外部データベース対応の記載はありません）。
• 取引を別のログファイルに記録し、国際化をサポートします。
• HeadDatabase の頭部とカスタムスカルテクスチャを GUI ボタンとしてサポートします。
• 作者は、機能とバージョン互換性の対象が Spigot であると述べています。他のサーバーソフトでは動作が異なる場合があります。

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

サーバーの経済と Vault に統合された、設定可能な GUI ベースのオークションシステムが欲しいなら、AuctionHouse は出品制御、検索/フィルタリング、手数料/税、取引ログを備え、管理しやすいプレイヤーマーケットを提供します。