Minecraftプラグイン ItemJoin

🔌 ItemJoinについて

ItemJoin は、プレイヤーに高度に設定可能なカスタムアイテムを自動で配布できる Minecraft プラグインです。アイテムは join、first-join、respawn、world-switch、region-enter、region-leave などのイベントで付与できます。プラグインは柔軟なアイテム定義（itemflags）、トリガーイベント、アイテムに紐づくコマンドに重点を置いており、サーバーがカスタムクライアント MOD なしでロビー用メニュー、スターターキット、状況に応じたツールを提供できるようにします。

🎯 目的

ItemJoin は、サーバーのイベントやワールドに紐づいたカスタムまたはインタラクティブなアイテムを、プレイヤーへ確実に配布する問題を解決します。ハブ/ロビーサーバー、ミニゲームサーバー、ワールドごとにアイテム制限が必要なサバイバルネットワーク、アイテム連動メニューやコマンド実行アイテムが必要なネットワークに向いています。

⚙️ 機能

• join、first-join、respawn、world-switch、region-enter/exit などの設定可能なトリガーでアイテムを付与。
• 各アイテムごとの itemflags により挙動を変更可能（slot、overwrite、スタックルール、移動/回収のブロック、gamemode 制限、受け取る確率、クールダウン）。
• ItemCommands: アイテムにコマンドを紐づけ、実行コンテキスト（console、player、server、message）とアクション種別（左/右クリック、インベントリクリック、物理、複数クリック）を設定可能。
• PlaceholderAPI 連携による動的なアイテム名/lore と placeholder 対応。
• カスタムプレイヤーヘッド（独自テクスチャと所有者）、マップ画像、tipped arrows、本、バナー、花火、革装備のカスタマイズ、カスタムエンチャントレベルに対応。
• 特定ワールドでのアイテム移動や取得を任意でブロックし、IP アドレスや first-join 状態によってアイテムを制限可能。
• ゲーム内 GUI 作成ツールでアイテムセットを構築でき、インポート/作成の組み込みワークフローも利用可能。
• 他プラグイン向け API: me.RockinChaos.itemjoin.api.ItemJoinAPI で利用可能。

🧩 対象ユーザー

• ロビー/ハブ用の自動アイテムやスターターキットが必要なサーバー運営者。
• ワールド固有アイテムやメニュー用コンパスが必要なミニゲーム/ネットワーク運営者。
• API 経由でフック可能なアイテムシステムを求める開発者。

🏗️ 使用例

• 参加時にメニューコンパスを配布し、クリックで異なるコマンドを実行させる。
• first-join 時に一度だけ使えるスターターキットを配布し、指定ワールド間でのアイテム移動を防ぐ。
• クールダウンとコスト付きで経済/ショップ系コマンドを実行するインタラクティブアイテムを作成する。

⌨️ コマンド

注: これらのコマンドとサブコマンドは、プラグインのドキュメント化されたコマンドセットに基づいています。さらに追加のサブコマンドが wiki や生成されるヘルプ出力に用意されています。

🔐 権限

アイテム固有の権限動作は設定可能です。アイテム権限チェックはデフォルトで無効になっており、効果を有効にするにはプラグイン設定で有効化する必要があります。

⚙️ インストール

📥 セットアップ

• 公式の ItemJoin jar をダウンロードし、サーバーの plugins/ フォルダに配置してください。
• plugins/ に ItemJoin の jar ファイルが重複していないことを確認してください（例: ItemJoin(1).jar）。
• プラグインが設定を生成し、サーバーのバージョン向けに機能を登録できるよう、サーバーを再起動してください。
• プラグインの読み込み確認のためサーバーコンソールのログを確認し、詳細なセットアップはプラグイン wiki を参照してください。

📦 依存関係

このプラグインには必須の実行依存はありませんが、一般的なソフト依存と連携がいくつかあります（存在する場合に任意で有効化されます）。

• Vault
• AuthMe
• BetterNick
• HeadDatabase
• PlaceholderAPI
• SkinRestorerX
• TokenEnchant
• WorldEdit
• WorldGuard

必要に応じて連携を有効化または設定してください。これらがなくても動作しますが、placeholder、カスタムヘッド/スキン、経済フックなどの機能は対応するプラグインに依存します。

🧠 技術メモ

• 対応プラットフォーム: Spigot 系サーバーで確認済み（Spigot, Bukkit, Paper, Purpur, Folia）。
• 対応/テスト済み Minecraft 範囲: 1.8 から 1.21 まで。
• ソースコードとリリースは公開されており、他プラグインが連携できるよう me.RockinChaos.itemjoin.api.ItemJoinAPI で API を公開しています。
• ライセンス: LGPL-3.0。

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

プレイヤーに文脈に応じたインタラクティブなアイテム（メニュー、スターターキット、ワールド固有ツール）を柔軟かつ設定可能な形で提供するシステムが必要で、さらに連携用 API も欲しいなら、ItemJoin は一般的な placeholder や skin プラグインにも対応しながらその機能を提供します。