YSS用に専用で開発した、ウェーブ制のPvEサバイバルや、プレイヤー同士の安全なPvPが楽しめるミニゲームプラグインです。
アリーナを設置し、仲間と共にモンスターの襲来を撃退、または実力を競い合いましょう！

アリーナバトルは、指定されたエリア内で戦う サバイバル＆対戦ミニゲーム です。

• 【PvE】フェーズ（ウェーブ）ごとにモンスターが出現し、全滅させると次のフェーズに進みます
• 【PvE】全フェーズをクリアすると 勝利！報酬アイテムを獲得できます
• 【PvE】通常のクリア型ステージのほか、限界に挑む 「エンドレスモード」 も搭載されています
• 【PvP】プレイヤー同士で安全に対戦できる 「PvPモード」 や、プラグインのステータス補正を無効化する 「フラットPvP」 も遊べます
• ソロでもパーティ（複数人）でも挑戦可能です
• ランキングシステムがあり、腕前を競えます

プレイヤーは自分専用のアリーナを設置できます。作成したプレイヤーがアリーナのオーナー（所有者）となり、管理を行うことができます。

【Tips】 設置アイテムは 確定時 に消費されます。スキャン段階ではまだ消費されません。

1. アリーナを設置したい場所の 中心 に立ちます
2. コマンドを実行します： /arena setup <サイズ>
   サイズは 16〜32 の範囲で指定できます（サイズ = 一辺の長さ）
3. エリア内のスキャンが自動的に行われます
   余分なブロックがある場合は数が表示されます（松明やランタンは除去対象外です）
   ※アリーナの設置には、周囲の指定ブロック範囲内および上方向(最低10ブロック)の空間が必要です。
4. 問題なければ確定します： /arena confirm
   キャンセルする場合： /arena cancel
5. 確定するとエリア内のブロックが自動で除去され、アリーナが登録されます。
   中央に 受付NPC（村人） が自動で出現します。

• 1人あたり最大 3個 まで設置可能です
• 他のアリーナと重なる場所には設置できません
• 設置したアリーナの床ブロックは保護されます

• アリーナ内に立った状態で実行： /arena delete
• またはIDを指定して削除： /arena delete <ID>

【注意】 バトル中のアリーナは削除できません。バトル終了後に削除してください。

1. アリーナに設置された 受付NPC（村人） を 右クリック します
2. ステージ選択GUI が開きます
3. 挑戦したいステージのアイコンをクリックします
4. 確認GUI が開きます — アリーナ内にいる全プレイヤーが参加者として表示されます
5. 「開始する」ボタン をクリックするとバトルが始まります（設定された待機時間「プレスタート」が始まります）

【パーティプレイの場合】 バトル開始前に仲間と一緒にアリーナ内に入ってください。アリーナ内にいるプレイヤー全員が自動的に参加者となります。また、待機時間中であれば中心のブロックをクリックすることで他プレイヤーも途中参加（共闘）が可能です。

1. 3秒カウントダウン の後、フェーズ1が開始されます
2. 画面にフェーズ番号がタイトル表示されます
3. モンスターがアリーナ内に次々とスポーンします
4. アクションバーに 「残りのMob: ○体」 と表示されます
5. 全モンスターを倒すとフェーズクリア！
6. 【重要】 ウェーブが切り替わるタイミングで、アリーナ内の炎（通常の炎やソウルファイア）は自動的に消火され、安全な状態から次フェーズがスタートします。
7. 約3秒のインターバルの後、次のフェーズが始まります
8. 最終フェーズをクリアすると 勝利 です

全滅するまでフェーズがループし続ける耐久モードです。

• 画面右側のスコアボードには、「WAVE数（周回内のフェーズ数）」と「(累計: XX)」として開始から何フェーズ目にあたるのかが併記されます。
• 周回を重ねるごとに、モンスターの体力・攻撃力・移動速度・サイズが強化されていきます。

プレイヤー同士で安全に対戦できるPvP専用のモードです。

• PvPの開始と設定: ステージ選択GUIの下部メニューから「通常PvPモード」または「フラットPvPモード」を選択すると、「PvP設定GUI」が開きます。
• フラットPvPモード: AuraSkillsプラグイン等によるステータス補正（HPや攻撃力など）を一時的に無効化し、純粋なバニラ状態での対等な実力勝負が可能なモードです。
• ルールのカスタマイズ: ホストは設定GUIから「不死のトーテム」「金のリンゴ」「エンチャントされた金のリンゴ」「バフポーション」「デバフポーション」の5項目の使用許可・禁止を個別に設定できます。設定完了後、「設定を完了して招待を送信」をクリックします。
• 参加の承諾と拒否: 招待が送信されると、アリーナ内の他プレイヤーに専用のGUIが表示されます。ホストが設定したこの試合のルールが一覧表示されるため、確認した上で「参加」か「拒否」を選択します。全員が「参加」を選ぶとカウントダウン後にバトルが始まります（誰か一人でも拒否したりESCキーでGUIを閉じたりした場合はキャンセルされます）。

バトル中はアリーナの境界が 赤いパーティクル で表示されます。
この範囲の外に出るとリタイアになるので注意してください。

• バトル中の活躍（与えたダメージや討伐貢献度など）に応じてポイントが蓄積されます。
• ステージクリア時、またはエンドレスモード終了時に、貢献度に応じたアイテム報酬がドロップします。
• 報酬は人数で均等割りされるのではなく、各自の 貢献度（Mobに与えたダメージ量） に応じて按分されます。
• 全くダメージを与えていない（貢献度0）場合は報酬は受け取れません。
• 報酬配布時のチャットメッセージには、実際にとどめを刺した純粋な「討伐数（キル数）」が表示されます。

※実行には rgarenabattle.admin パーミッションが必要です。

プラグインの基礎的な動作設定は config.yml で行います。

• アリーナ設置条件: 設置に必要なブロックの種類、最小/最大半径、必要上空高さ
• クールダウン・タイムアウト: アリーナ設置のクールダウン、ゲーム開始前の待機時間、放置時のタイムアウト（無人になってから終了するまでの時間）
• PvP（フレンドリーファイア）設定: PvEバトル中の参加者同士の攻撃判定の有無
• デスペナルティ: PvEバトル中に死亡した場合の経験値ロスト率（0に設定でロストなし）

このプラグインでは、単一の stages.yml ではなく、plugins/RGArenaBattle/stages/ フォルダ内にあるYAMLファイルの名前がそのまま「ステージID」になります。

例: stage_easy.yml というファイル名で保存した場合、そのステージのIDは stage_easy になります。
ジェネレーター等で作成したYAMLコードは、stages/ フォルダ内に 半角英数字の好きな名前.yml として新規作成して保存してください。
ステージを追加・変更した後は、サーバー内で /arena reload を実行すると即座に反映されます。

プラグインの tools/ フォルダ内に YSS_ArenaBattleStageGenerator.html が同梱されています。 ブラウザで開くだけで動作し、モダンな直感的UIを使って stages.yml 用のコードを自動生成できます。
プレビューを見ながらモブの体力、移動速度、攻撃力、サイズ、特殊演出、エンドレスモードの設定などをポチポチ選ぶだけで作成でき、リアルタイムでYAML形式に出力されるため、手動で書く前にジェネレーターを活用することをおすすめします！

stages.yml では、ステージごとに複数のフェーズや、エンドレスモードの設定が可能です。

フェーズごとに boss-phase: true を設定することでボスラウンド化でき、さらに個別のMobに spawn-effect を設定することで、出現時に特別な演出を行うことができます。

利用可能な演出一覧（周辺プレイヤーにのみ聞こえるローカル仕様）：

• LIGHTNING: 落雷の音とフラッシュエフェクト（ダメージや発火なし）
• EXPLOSION: 爆発音と爆発パーティクル（地形破壊やダメージなし）
• MINI_BOSS: 小ボス向け。ゾンビ村人治療音＋エンダードラゴンの羽ばたき音＋炎のパーティクル
• MID_BOSS: 中ボス向け。ウィザーの召喚音（やや高音）＋落雷音＋爆発パーティクル
• BOSS_WITHER: 大ボス向け。ウィザーの召喚音（重低音）＋ソウルファイアの青いパーティクル大量

ボスの設定例：

        - type: ZOMBIE
          count: 1
          health: 500.0
          speed: 1.2
          scale: 2.5
          spawn-effect: BOSS_WITHER

エンドレスモードでは、周回ごとの難易度上昇カーブを細かくコントロールできます。

• health-multiplier : 体力倍率
• damage-multiplier : 攻撃力倍率
• speed-multiplier : 移動速度倍率

スケルトンなどのデフォルト武装は維持されますが、equipment 項目で上書き可能です。 アンデッド系（ゾンビやスケルトン）は日光で燃えないよう、指定がない場合は自動的に「革の帽子」を被ってスポーン します。

        equipment:
          mainhand:
            material: DIAMOND_SWORD
          helmet:
            material: IRON_HELMET

※防具や武器にはバニラのエンチャントは付与されず（ドロップも0%）、純粋なパラメータ勝負となる仕様に調整されているため、不公平な事故を防ぎます。

装備には特定のエンチャントを指定レベルで付与することができます。 HTMLジェネレーターを使うと自動で入力されますが、手動でYAMLを書く場合のエンチャント指定名称（主なもの）は以下の通りです：

設定例（ダイヤの剣にダメージ増加5と火属性2を付与）：

        equipment:
          mainhand:
            material: DIAMOND_SWORD
            enchantments:
              sharpness: 5
              fire_aspect: 2