Minecraftプラグイン PhoenixCrates

🔌 Phoenix Crates について

Phoenix Crates は、サーバー上で crate/報酬システムを運用するための Minecraft プラグインです。crate の種類、キー（物理キーと仮想キー）、アニメーション付きの開封演出、そして生ファイルを編集せずに crate や報酬を作成・管理できるゲーム内エディタを提供します。プロジェクトは Phoenix Plugins により公開されており、無料版と追加機能付きの有料プレミアム版があります。

🎯 目的

サーバー管理者向けに、アニメーション付きの開封を表示し、キーや仮想通貨風のキーを管理し、スタッフがゲーム内で crate と報酬を作成・編集できる、設定可能な報酬/crate システムを提供することです。イベント風やショップ/報酬系の仕組みを求めるサーバー向けです（例：報酬配布、ストア crate、イベント賞品）。

⚙️ 機能

• 複数の crate エンジンモード（バニラブロック、バニラモデル、Model Engine 連携）。
• 設定可能なフェーズと組み合わせを持つ、アニメーション付き開封シーケンスと待機アニメーション。
• 物理キーと仮想キーの管理（仮想キー用メニュー、支払い/転送、give/take/set コマンド）。
• crate、キー、報酬、アニメーションを作成/編集できるゲーム内エディタ。
• ランダム報酬と選択式報酬（プレイヤーが選ぶ）、再抽選、確定報酬を含む報酬タイプ。
• アドオンとプレミアム特典（追加アニメーション、MySQL 対応、API、プレミアムプランでのアドオン導入）。
• 一部のアニメーションとモデルに対する Bedrock/Geyser の基本表示サポート。
• サーバー側のプレビューと報酬管理ツール（全体/プレイヤーごとの当選制限、クールダウンリセット）。

🧩 対象ユーザー

• crate や報酬システムを導入する Survival/SMP および経済系サーバー。
• アニメーション付き/視覚的な crate 開封とモデル対応（Model Engine）を求めるサーバー。
• 手動でファイル編集するより、ゲーム内エディタで crate を設定したい管理者。

🏗️ 使用例

• プレイヤーに仮想キーを配布し、GUI で消費して装飾品やアイテム crate を開ける。
• クリスマスなど季節イベント向けの crate を、カスタム開封アニメーションと限定報酬つきで作成する。
• ゲーム内エディタを使って、YAML を手動編集せずに crate 設定を移行または再構築する。

⌨️ コマンド

(上記のコマンドは、Phoenix Crates の公式ドキュメントおよびコマンドリファレンスに基づいています。)

🔐 権限

(プロジェクトで明示的に文書化されている権限ノードのみを掲載しています。)

⚙️ インストール

📥 セットアップ

• 公式の Phoenix Crates プラグイン JAR をダウンロードするか、公式配布チャネルから入手します。
• 対応サーバーでは、JAR をサーバーの plugins/ ディレクトリに配置します（技術メモを参照）。
• サーバーを起動または再起動し、コンソールでプラグインが読み込まれたことを確認します。
• ゲーム内エディタまたは提供コマンドを使って crate とキーを作成します。プラグインには再読み込みコマンドとエディタコマンドもあります。

📦 依存関係

• デフォルトでは必須のサードパーティ依存関係は記載されていません。プラグインは、カスタムモデル用の Model Engine などの任意システムと連携し、更新履歴で言及されるプレースホルダーを提供します。

🧠 技術メモ

• 対応サーバーソフトウェア（作者の説明による）：Spigot および Spigot 系 fork、Paper および Paper 系 fork、Folia。
• 対応 Minecraft バージョン：ドキュメントによると、Phoenix Crates（記載バージョン時点）は Minecraft 1.20.4+ をサポートしています（古いバージョンのサポートは記載のメジャーリリース時に終了）。
• 任意の連携：Model Engine（カスタムアニメーションモデル）、Bedrock 表示向けの GeyserMC 互換メモ、更新で言及される PlaceholderAPI プレースホルダー。
• プロジェクトは無料版とプレミアム版で提供され、プレミアムでは MySQL 対応、公開 API アクセス、無制限の crate、追加アニメーション、アドオンなどが追加されます。

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

設定可能でアニメーション駆動の crate システムが必要で、ゲーム内エディタと任意のモデル/Bedrock 対応が欲しいなら、Phoenix Crates はプレイヤー向けの見た目と、サーバー上で報酬やキーを管理する管理者ツールの両方を提供します。