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

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

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

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

【Tips】 設置アイテムは 確定時 に消費されます。スキャン段階ではまだ消費されません。
YS円は口座から直接引き落とされます。

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

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

• 的ブロックによるスポーン制御
  • アリーナ境界から外側8ブロック以内に「的（ターゲット）ブロック (TARGET_BLOCK)」を設置すると、そこが専用のリスポーン地点として自動認識されます。
  • PvPやPvEで死亡してリスポーンする際、初期スポーンやアリーナ中央ではなく、最優先で的ブロックの上にリスポーンするようになります。
  • 的ブロックを複数設置した場合は、その中からランダムな的ブロックの上にプレイヤーが振り分けられます。
  • （観戦席などに的ブロックを床として埋め込んでおくことで、死亡したプレイヤーをスムーズに観客席へ移動させることができます）

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

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

鉄取の中央ワープルームに専用のSSGが設置されています。

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から「不死のトーテム」「金のリンゴ」「エンチャントされた金のリンゴ」「バフポーション」「デバフポーション」「飛翔物(弓、トライデントなど)」の6項目の使用許可・禁止を個別に設定できます。
• 制限時間の設定も可能で、時間を過ぎた場合サドンデスマッチに移行します。
• 設定完了後、「設定を完了して招待を送信」をクリックします。
• 参加の承諾と拒否: 招待が送信されると、アリーナ内の他プレイヤーに専用のGUIが表示されます。ホストが設定したこの試合のルールが一覧表示されるため、確認した上で「参加」か「拒否」を選択します。全員が「参加」を選ぶとカウントダウン後にバトルが始まります（誰か一人でも拒否したりESCキーでGUIを閉じたりした場合はキャンセルされます）。
• 途中退出時の挙動: 参加者がバトルエリア外に出てリタイアした場合も試合は正常に終了扱いとなり、受付NPCが再出現します。

各フェーズ（ウェーブ）をクリアするごとに、装備修繕サポートとしてアリーナの中央上空から経験値瓶が降り注ぎます。
降ってくる経験値瓶の数は、「現在のフェーズ数」と「生き残っている人数」によって自動的に計算されます。

多人数で参加した際に経験値が増えすぎないよう、人数の増加に対して緩やかにボーナスがかかる特殊な計算式（累乗カーブ）を採用しています。

• 基本ドロップ数 = クリアしたフェーズ数 × 基本倍率(1.0)
• 人数ボーナス = 生き残っている人数 ^(0.5) （人数の0.5乗 ＝ 平方根）
• 最終ドロップ数 = 基本ドロップ数 × 人数ボーナス （※小数点切り捨て）

【人数ごとのドロップ倍率の目安】
（※設定値が0.5の場合）

人数が増えるほど1人あたりの取り分は少し減ってしまいますが、大人数になるほど攻略の安定感やクリア速度が上がるため、ゲームバランスを崩さないための仕様となっています。仲間と協力してより高いフェーズを目指しましょう！

アリーナの境界はパーティクルで視覚的に表示されます。

• 待機中: 境界線に白い少量のパーティクルが表示されます。
• バトル中: 境界線が 赤いパーティクル で表示されます。この範囲の外に出るとリタイアになります。

• バトル中に討伐したMobの最大体力に応じて、貢献度ポイントが蓄積されます。
• ステージクリア時、またはエンドレスモード終了時に、貢献度に応じた アイテム報酬とYS円報酬 を獲得できます。
• 報酬は人数で均等割りされるのではなく、各自の 貢献度（討伐したMobの最大体力を基準にしたスコア） に応じて按分されます。
• YS円報酬は現物通貨アイテムでは配布されず、YS-Bankの口座へAPI経由で直接入金されます。
• 全く討伐に貢献していない（貢献度0）場合、通常のアイテム・YS円報酬は受け取れません。
• 報酬配布時のチャットメッセージには、実際にとどめを刺した純粋な「討伐数（キル数）」が表示されます。

• フェーズ報酬・最終クリア報酬として設定されたYS円を合算し、参加者の貢献度に応じて山分けします。
• 通常報酬の山分け額は、YS-Bank側で設定されている最小通貨単位に合わせて計算されます。
• 入金完了時には、本人へ 「実際に増えた金額」と「入金後の口座残高」 がチャット表示されます。
• プレイヤーがオフラインの場合も報酬は消失せず、安全な入金待ちとして保存され、次回オンライン時に自動入金されます。

プレイヤーが設置したアリーナを、オーナー以外のプレイヤーが通常ステージでクリアすると、そのアリーナのオーナーへYS円ボーナスが入金されます。

有料ステージへ複数人で挑戦してクリアした場合、そのゲームの参加費を全額支払ったホストを「パーティリーダー」として、通常の取り分とは別にYS円ボーナスが加算されます。

• ボーナス額 = 参加者へ山分けされるYS円通常報酬の合計 × config指定率 ÷ 100
• 計算結果に小数が出た場合は、小数部分だけを切り捨てます。四捨五入・切り上げは行いません。
• ボーナスは口座へ直接振り込まれるため、YS-Bankの最小通貨単位には丸めず、1円単位の整数額をそのまま入金します。
• 通常の貢献度山分け総額からボーナス分を差し引くことはありません。通常報酬へ別枠で上乗せされます。
• 入金待ち保存時と入金完了時に通知され、完了通知には ボーナスの種類・実際の増加額・入金後残高 が表示されます。

例：YS円通常報酬の山分け合計が 12,390円、オーナー率 7％、リーダー率 5％ の場合

次の場合、オーナー／リーダーボーナスは発生しません。

• 敗北、時間切れ、途中終了
• エンドレスモード終了
• PvP・フラットPvP
• 参加者へ山分けされるYS円通常報酬の合計が0円
• オーナーボーナス：運営・admin設置アリーナ、またはオーナー本人が参加
• リーダーボーナス：ソロプレイ、または参加費が設定されていない無料ステージ

コマンドを実行すると、チェスト型のインベントリGUIでランキングを確認できます。

• スカル表示: ランキング上位プレイヤーがプレイヤースカルとして表示されます。
• 詳細な成績: スカルにカーソルを合わせると、「順位」「クリア回数（エンドレス到達フェーズ）」「合計討伐数」「種類別討伐数（ゾンビ○体、スケルトン○体など）」が表示されます。
• 操作の切り替え: GUI画面下部のボタンをクリックして、「ページ送り/戻し」や「Solo/Partyモードの切り替え」が可能です。

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

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

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

オーナー／リーダーボーナスの割合は config.yml で指定します。既存configに項目がない場合は 0 として扱われ、ボーナスは無効です。

ys-bank:
  minimum-unit-fallback: 10
  clear-bonuses:
    # プレイヤー設置アリーナのオーナーボーナス率（0で無効）
    arena-owner-percent: 10
    # 有料の複数人戦におけるリーダーボーナス率（0で無効）
    party-leader-percent: 5

設定変更後は /arena reload を実行してください。割合は0〜100％の範囲で読み込まれ、ボーナス計算で発生した小数円は切り捨てられます。

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

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

プラグインの tools/ フォルダ内に YSS_ArenaBattleStageGenerator.html が同梱されています。ブラウザで開くだけで動作し、UIからモブの体力、移動速度、攻撃力、サイズ、特殊演出、エンドレスモードの設定などを行い、リアルタイムで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%）、純粋なパラメータ勝負となる仕様に調整されているため、不公平な事故を防ぎます。

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

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

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