ExcellentCrates は、Spigot/Paper サーバー向けの Minecraft プラグインで、機能豊富な crates（lootbox）システムを実装します。設定可能な crate 種類、キー管理（仮想キーと物理キー）、そしてサーバー管理者が主にゲーム内 GUI エディタから管理できる柔軟な報酬定義に重点を置いています。

🎯 目的

このプラグインは、手動でファイルを編集せずに、サーバー上で crate ベースの報酬を作成・設定・表示する問題を解決します。イベント、デイリー報酬、課金要素、プレイヤーの進行報酬などに crate を使いたいサーバーオーナーや管理者向けで、設定やプレビューをゲーム内で扱えるようにします。

⚙️ 機能

ゲーム内 GUI エディタで crates、キー、報酬を作成・管理。
物理キーと仮想キーに対応（仮想キーは取引・共有を防止）。
crate ブロック向けの内蔵ホログラムとパーティクル効果（いくつかのホログラム機能では追加プラグインが必要な場合があります）。
Crate Blocks: crates を物理ブロック/ゾーンに紐づけて、ワールド内で crate とやり取りできるようにします。
crate ごとにカスタムのプレビュー GUI と開封 GUI を設定可能。
報酬タイプ: アイテム報酬とコマンド報酬。
バンドル対応: 報酬ごとに複数のアイテムスタックを設定可能（アイテム報酬あたり最大 27 アイテムという記載あり）で、コマンド報酬は無制限。
報酬確率のバランス調整用のレアリティと重み。
マイルストーンと一括開封機能。
開封クールダウンとプレイヤーごとの開封コスト（開封コスト機能により経済連携が示唆されています）。
crates と報酬に対する権限要件とキー要件。
報酬の上限（全体およびプレイヤーごと）と報酬の通知/ログ記録。
公式情報で示されている PlaceholderAPI 対応。

🧩 対象ユーザー

イベント、課金、プレイヤーの参加促進に crates を使う公開・非公開の Spigot/Paper サーバー。
手動の YAML 編集よりもゲーム内エディタを好むサーバー管理者。

🏗️ 使用例

レアリティと重み付き報酬を持つ crate を設定し、スポーンに crate ブロックを置いて、プレイヤーに開封用の仮想キーを配布する。
crate のプレビューとホログラムを作成して、プレイヤーがキーを使う前に報酬を確認できるようにする。
一括開封とマイルストーンを使って、期間限定イベントを実施したり、アクティブなプレイヤーに報酬を与えたりする。

⚙️ インストール

📥 セットアップ

公式のプラグイン JAR をダウンロードし、対応が確認されているサーバービルド（Spigot または Paper）の plugins/ ディレクトリに配置します。
サーバーを再起動し、コンソールでプラグインが読み込まれたことを確認します。
プラグインが補助エンジン依存関係を必要とする場合は、必要な依存プラグイン（nightcore）を ExcellentCrates の前または同時にインストールしてください。

📦 依存関係

必須: nightcore（プラグインエンジン）。公式情報で示されています。
任意: 高度なホログラム機能用に ProtocolLib または PacketEvents。テキスト内のプレースホルダーには PlaceholderAPI が対応しています。

🧠 技術メモ

対応が確認されているサーバーソフトウェア: Spigot と Paper。
確認済みの最低サーバーバージョン要件: 1.21.8 以上（プロジェクト記載）。
確認済みの Java 要件: Java 21 以上。
Folia と Forge のサポートは明示的に未対応。
プロジェクトリポジトリには GPL-3.0 ライセンスが記載されています。

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

Spigot/Paper サーバー向けに、仮想/物理キー、ホログラム、柔軟な報酬定義（アイテム、コマンド、レアリティ、上限）を備えたゲーム内で設定可能な crate システムが必要なら、ExcellentCrates はそれらの機能と、手動でのファイル編集をほとんど必要としない設定ワークフローを提供します。

プラグイン ExcellentCrates のサーバー