🏪 Best Auction Plugin

完全な機能を備えたMinecraft Paper/Spigotサーバー用オークションハウスプラグインです。プレイヤーがアイテムを出品・入札・購入できる包括的な市場システムを提供します。

✨ 主な機能

• 🏪 完全なオークションシステム - 出品、入札、即決購入
• 💰 Vault経済連携 - 既存の経済プラグインとシームレスに統合
• 📬 メールシステム - アイテムと返金の自動配送
• 🌐 多言語対応 - 日本語・英語完全対応
• 🔍 シンプルなカテゴリ - 6つの直感的なカテゴリ（すべて・ブロック・食品・武器装備・エンチャント・その他）
• 🔍 高度な検索 - キーワード検索
• ⏰ 残り時間表示 - リアルタイムでオークション終了時間を表示
• ⚙️ 高度な設定 - 手数料、期間、通貨表示など細かく調整可能
• 📊 K/M/B表記 - 大きな金額の見やすい表示
• ☁️ クラウド連携 - オークションデータの外部同期とイベント送信

🛠️ 必要要件

• Minecraft: 1.20.1+
• サーバー: Paper/Spigot
• Java: 17+
• 依存関係:
  • Vault（推奨）
  • 経済プラグイン（EssentialsX等）

📥 インストール

Modrinthから（推奨）

1. Modrinthページからダウンロード
2. plugins/フォルダに配置
3. サーバーを再起動

GitHubから

1. Releasesから最新版をダウンロード
2. plugins/フォルダに配置
3. サーバーを再起動

🎮 使い方

基本コマンド

/ah                          # オークションハウスを開く
/ah sell <価格> [即決価格]      # アイテムを出品
/ah bid <ID> <金額>           # アイテムに入札
/ah search <キーワード>        # アイテムを検索
/ah mail                     # メールボックスを開く

設定例

# config.yml
auction:
  default_duration: 168      # 7日間（時間単位）
  listing_fee_rate: 0.05     # 5%の手数料
  
ui:
  date_format: "yyyy年MM月dd日"  # 日付表示形式
  
language: "ja"               # 言語設定

# クラウド連携（オプション）
cloud:
  enabled: false
  base_url: "https://your-worker.your-subdomain.workers.dev"
  api_token: ""
  server_id: "default-server"

☁️ クラウド連携

Best Auctionは、オークションデータを外部クラウドサービスと同期する機能を提供します。これにより、複数サーバー間でのデータ共有、分析、バックアップが可能になります。

クラウド連携機能

• リアルタイムイベント送信 - 出品、入札、落札などのイベントを即座に送信
• データ同期 - オークションデータの定期的な同期
• APIトークン認証 - セキュアな認証機構
• 自動リトライ - 失敗時の自動再送信

イベントタイプ

1. ITEM_LISTED - アイテムが出品された時
2. BID_PLACED - 入札が行われた時
3. BID_CANCELLED - 入札がキャンセルされた時
4. AUCTION_CANCELLED - オークションがキャンセルされた時
5. ITEM_SOLD - アイテムが落札された時

データフォーマット

クラウドに送信されるイベントはJSON形式で、ISO 8601形式のタイムスタンプ（UTC）を含みます：

{
  "event_type": "ITEM_LISTED",
  "server_id": "server-1",
  "timestamp": "2025-06-28T14:30:45.123Z",
  "auction_id": 123,
  "data": {
    "seller_uuid": "uuid-here",
    "seller_name": "PlayerName",
    "item_name": "Diamond Sword",
    "item_type": "DIAMOND_SWORD",
    "quantity": 1,
    "start_price": 1000,
    "buyout_price": 5000
  }
}

クラウドコマンド

/ah cloud status       # クラウド連携の状態を表示
/ah cloud validate     # APIトークンの検証
/ah cloud sync [force] # 手動でデータを同期

セットアップ

1. クラウドサービス（Cloudflare Workers等）をデプロイ
2. APIトークンを取得
3. config.ymlでクラウド設定を有効化
4. サーバーを再起動

詳細な設定手順はCLOUD_SETUP_GUIDE.mdを参照してください。

📚 ドキュメント

詳細な使用方法と設定については、PLUGIN_DOCUMENTATION.mdをご覧ください。

🔧 開発

ビルド

git clone https://github.com/0x48lab/best_auction.git
cd best_auction
./gradlew shadowJar

開発サーバー起動

./gradlew runServer

プロジェクト構造

src/main/kotlin/com/hacklab/best_auction/
├── Main.kt                 # メインクラス
├── commands/              # コマンド処理
├── managers/              # ビジネスロジック
├── ui/                    # GUI関連
├── utils/                 # ユーティリティ
├── data/                  # データクラス
└── database/              # データベース定義

🚀 デプロイメント

このプロジェクトは GitHub Actions を使用して自動デプロイを行います：

1. v*タグをプッシュ（例：v1.0.0）
2. 自動的にビルドが実行
3. GitHub Releases にリリース作成
4. Modrinth に自動デプロイ

リリース手順

git tag v1.0.0
git push origin v1.0.0

🤝 コントリビューション

1. このリポジトリをフォーク
2. フィーチャーブランチを作成 (git checkout -b feature/amazing-feature)
3. 変更をコミット (git commit -m 'Add amazing feature')
4. ブランチにプッシュ (git push origin feature/amazing-feature)
5. プルリクエストを作成

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルをご覧ください。

🆘 サポート

• 🐛 バグ報告: GitHub Issues
• 💡 機能要望: GitHub Discussions
• 📧 直接連絡: プロジェクト管理者まで

🏆 謝辞

このプラグインは Claude Code の支援を受けて開発されました。

---

🌟 このプラグインが役に立ったら、ぜひスターをお願いします！