差分

このページの2つのバージョン間の差分を表示します。

--- 仕様・機能:アリーナバトル [2026/06/13 16:57] – Ra-gu
+++ 仕様・機能:アリーナバトル [2026/07/17 15:27] (現在) – Ra-gu
@@ 行 2: / 行 2: @@
 {{:仕様・機能:2026-06-14_00.19.08.jpg?380|}}
-YSS用に専用で開発した、ウェーブ制のPvEサバイバルや、プレイヤー同士の安全なPvPが楽しめるミニゲームプラグインです。
+ウェーブ制のPvEサバイバルや、プレイヤー同士の安全なPvPが楽しめるミニゲームプラグインです。
 アリーナを設置し、仲間と共にモンスターの襲来を撃退、または実力を競い合いましょう！
@@ 行 10: / 行 10: @@
   * 【PvE】フェーズ（ウェーブ）ごとにモンスターが出現し、全滅させると次のフェーズに進みます
-  * 【PvE】全フェーズをクリアすると **勝利**！報酬アイテムを獲得できます
+  * 【PvE】全フェーズをクリアすると **勝利**！貢献度に応じた報酬アイテム・YS円を獲得できます
   * 【PvE】通常のクリア型ステージのほか、限界に挑む **「エンドレスモード」** も搭載されています
   * 【PvP】プレイヤー同士で安全に対戦できる **「PvPモード」** や、プラグインのステータス補正を無効化する **「フラットPvP」** も遊べます
@@ 行 20: / 行 20: @@
 プレイヤーは自分専用のアリーナを設置できます。作成したプレイヤーがアリーナのオーナー（所有者）となり、管理を行うことができます。
-==== 設置に必要なもの ====
+==== 設置に必要なもの(両方必要です) ====
 ^ アイテム ^ 数量 ^
 | ダイヤモンド | 50個 |
-| ネザライトインゴット | 5個 |
+| YS円 | 2,500円 |
 > **【Tips】** 設置アイテムは **確定時** に消費されます。スキャン段階ではまだ消費されません。
+> YS円は口座から直接引き落とされます。
 ==== 設置の手順 ====
   - アリーナを設置したい場所の **中心** に立ちます
-  - コマンドを実行します： ''/arena setup <サイズ>'' \\ サイズは 16〜32 の正方形の範囲で指定できます（サイズ = 一辺の長さ）
+  - コマンドを実行します： ''/arena setup <サイズ>'' \\ サイズは半径 16〜32 の正方形の範囲で指定できます（サイズ = 一辺の長さ）
   - エリア内のスキャンが自動的に行われます \\ 余分なブロックがある場合は数が表示されます（松明やランタンは除去対象外です） \\ ※アリーナの設置には、周囲の指定ブロック範囲内および上方向(最低10ブロック)の空間が必要です。
   - 問題なければ確定します： ''/arena confirm'' \\ キャンセルする場合： ''/arena cancel''
@@ 行 41: / 行 42: @@
   * 他のアリーナと重なる場所には設置できません
   * 設置したアリーナの床ブロックは保護されます
+==== カスタムリスポーン地点（的ブロック連携） ====
+  * **的ブロックによるスポーン制御**
+    * **アリーナ境界から外側8ブロック以内**に「的（ターゲット）ブロック (TARGET_BLOCK)」を設置すると、そこが専用のリスポーン地点として自動認識されます。
+    * PvPやPvEで死亡してリスポーンする際、初期スポーンやアリーナ中央ではなく、**最優先で的ブロックの上にリスポーン**するようになります。
+    * 的ブロックを複数設置した場合は、その中からランダムな的ブロックの上にプレイヤーが振り分けられます。
+    * （観戦席などに的ブロックを床として埋め込んでおくことで、死亡したプレイヤーをスムーズに観客席へ移動させることができます）
 ==== アリーナの削除 ====
@@ 行 48: / 行 56: @@
 > **【注意】** バトル中のアリーナは削除できません。バトル終了後に削除してください。
-<note important>特盛とエンドレスモードは、運営公式で設置されているアリーナでのみ遊べます
-個々で設置したアリーナではプレイできません</note>
+<note important>
+特盛とエンドレスモードは、運営公式で設置されているアリーナでのみ遊べます。
+個々で設置したアリーナではプレイできません。
+</note>
 ==== 運営公式アリーナへのアクセス ====
-鉄取の中央ワープルームに専用のSSGが設置されています
+鉄取の中央ワープルームに専用のSSGが設置されています。
 {{:仕様・機能:2026-06-14_00.24.36.jpg?600|}}
@@ 行 73: / 行 85: @@
   - アクションバーに **「残りのMob: ○体」** と表示されます
   - 全モンスターを倒すとフェーズクリア！
-  - **【重要】** ウェーブが切り替わるタイミングで、アリーナ内の炎（通常の炎やソウルファイア）は自動的に消火され、安全な状態から次フェーズがスタートします。
+  - **【重要】** ウェーブが切り替わるタイミングで、アリーナ内の「水」「溶岩」「炎（ソウルファイア含む）」は自動的に消去され、安全な状態から次フェーズがスタートします。
   - 約3秒のインターバルの後、次のフェーズが始まります
   - 最終フェーズをクリアすると **勝利** です
@@ 行 89: / 行 101: @@
   * **PvPの開始と設定**: ステージ選択GUIの下部メニューから「通常PvPモード」または「フラットPvPモード」を選択すると、**「PvP設定GUI」**が開きます。
   * **フラットPvPモード**: AuraSkillsプラグイン等によるステータス補正（HPや攻撃力など）を一時的に無効化し、純粋なバニラ状態での対等な実力勝負が可能なモードです。
-  * **ルールのカスタマイズ**: ホストは設定GUIから「不死のトーテム」「金のリンゴ」「エンチャントされた金のリンゴ」「バフポーション」「デバフポーション」の5項目の使用許可・禁止を個別に設定できます。設定完了後、「設定を完了して招待を送信」をクリックします。
+  * **ルールのカスタマイズ**: ホストは設定GUIから「不死のトーテム」「金のリンゴ」「エンチャントされた金のリンゴ」「バフポーション」「デバフポーション」「飛翔物(弓、トライデントなど)」の6項目の使用許可・禁止を個別に設定できます。
+  * **制限時間の設定も可能**で、時間を過ぎた場合**サドンデスマッチに移行します。**
+  * 設定完了後、「設定を完了して招待を送信」をクリックします。
   * **参加の承諾と拒否**: 招待が送信されると、アリーナ内の他プレイヤーに専用のGUIが表示されます。ホストが設定したこの試合のルールが一覧表示されるため、確認した上で「参加」か「拒否」を選択します。全員が「参加」を選ぶとカウントダウン後にバトルが始まります（誰か一人でも拒否したりESCキーでGUIを閉じたりした場合はキャンセルされます）。
+  * **途中退出時の挙動**: 参加者がバトルエリア外に出てリタイアした場合も試合は正常に終了扱いとなり、受付NPCが再出現します。
 ==== バトル中のルール ====
-^ ルール                     ^ 内容                                                                                                                                         ^
+^ ルール ^ 内容 ^
-| 死亡時                     | 死亡時に所持経験値から5％引かれます  ** その他アイテムはロストしませんが、耐久値は減るので注意**                  |
+| 死亡時 | 所持経験値から5％減少します。アイテムはロストしませんが、装備の耐久値は減少します |
-| エリア外に出た場合         | **リタイア扱い** になります                                                                                                                  |
+| エリア外への退出 | **リタイア扱い** になります |
-| 勝敗判定                   | 【PvE】全員死亡または時間切れで敗北。【PvP】死亡者はアリーナ外へ転送されて敗北となり、最後まで生き残った勝者に「VICTORY」が表示されます      |
+| 勝敗判定 | 【PvE】全員死亡または時間切れで敗北。【PvP】死亡者はアリーナ外へ転送されて敗北となり、最後まで生き残った勝者に「VICTORY」が表示されます |
-| 外部プレイヤー             | バトル中のアリーナには **侵入できません**                                                                                                    |
+| 外部プレイヤー | バトル中のアリーナには **侵入できません** |
-| 外部からの干渉             | アリーナ外から投げ込まれたポーションや矢は **無効化** されます                                                                               |
+| 外部からの干渉 | アリーナ外から投げ込まれたポーションや矢は **無効化** されます |
-| アイテム制限（PvE時）      | バランス調整のため、PvE中はプレイヤーによる**スプラッシュポーションや残留ポーションの投擲が禁止**されています（モンスターからの投擲は有効）  |
+| アイテム制限（PvE時） | PvE中はプレイヤーによる**スプラッシュポーションや残留ポーションの投擲が禁止**されています（モンスターからの投擲は有効です） |
-| ウィンドチャージ（PvE時）  | PvE中にプレイヤーが使用すると、ペナルティとして**一時的なデバフ（移動速度低下II・弱体化II）**が付与されます                                  |
+| バケツの使用制限 | OP権限を持たない一般プレイヤーは、待機中・バトル中に関わらずアリーナ領域内で水・溶岩バケツを使用できません |
-| 接続切断                   | **60秒以内** に再接続すれば復帰できます                                                                                                      |
+| ウィンドチャージ（PvE時） | PvE中にプレイヤーが使用すると、ペナルティとして**一時的なデバフ（移動速度低下II・弱体化II）**が付与されます |
-| ブロック                   | バトル中はアリーナ内のブロック破壊・設置が **禁止** されます                                                                                 |
+| 不死のトーテム | PvP設定で許可した場合のみ正常に発動します。PvE中（通常ステージ）では無効化されます |
-| 爆発と地形破壊             | アリーナ内のブロックは爆発から **保護** されます。ウィザーなどのボスによる地形破壊も無効化されます                                           |
+| 接続切断 | **120秒以内** に再接続すれば復帰できます |
-| 同士討ち防止               | モンスター同士の同士討ちが起こらないよう制御されています                                                                                     |
+| ブロック | バトル中はアリーナ内のブロック破壊・設置が **禁止** されます |
+| 爆発と地形破壊 | アリーナ内のブロックは爆発から **保護** されます。ウィザーなどのボスによる地形破壊も無効化されます |
+| 同士討ち防止 | モンスター同士の同士討ちが起こらないよう制御されています |
+==== フェーズクリア時の経験値報酬について ====
+各フェーズ（ウェーブ）をクリアするごとに、装備修繕サポートとしてアリーナの中央上空から経験値瓶が降り注ぎます。
+降ってくる経験値瓶の数は、**「現在のフェーズ数」**と**「生き残っている人数」**によって自動的に計算されます。
+==== 経験値瓶のドロップ数 計算式 ====
+多人数で参加した際に経験値が増えすぎないよう、人数の増加に対して緩やかにボーナスがかかる特殊な計算式（累乗カーブ）を採用しています。
+  * **基本ドロップ数** = ''クリアしたフェーズ数 × 基本倍率(1.0)''
+  * **人数ボーナス** = ''生き残っている人数 ^(0.5)'' （人数の0.5乗 ＝ 平方根）
+  * **最終ドロップ数** = ''基本ドロップ数 × 人数ボーナス'' （※小数点切り捨て）
+**【人数ごとのドロップ倍率の目安】**
+（※設定値が0.5の場合）
+^ 生存人数 ^ 人数ボーナス倍率 ^ 備考 ^
+| 1人 | **1.00 倍** | 基準値 |
+| 2人 | **1.41 倍** | 1人の時の約1.4倍 |
+| 3人 | **1.73 倍** | |
+| 4人 | **2.00 倍** | 4人揃ってようやく2倍になります |
+| 6人 | **2.44 倍** | |
+| 10人 | **3.16 倍** | |
+人数が増えるほど1人あたりの取り分は少し減ってしまいますが、大人数になるほど攻略の安定感やクリア速度が上がるため、ゲームバランスを崩さないための仕様となっています。仲間と協力してより高いフェーズを目指しましょう！
 ==== エリア境界 ====
-バトル中はアリーナの境界が **赤いパーティクル** で表示されます。
+アリーナの境界はパーティクルで視覚的に表示されます。
-この範囲の外に出るとリタイアになるので注意してください。
+  * **待機中**: 境界線に白い少量のパーティクルが表示されます。
+  * **バトル中**: 境界線が **赤いパーティクル** で表示されます。この範囲の外に出るとリタイアになります。
 ==== 報酬と貢献度 (PvEモード) ====
-  * バトル中の活躍（与えたダメージや討伐貢献度など）に応じてポイントが蓄積されます。
+  * バトル中に討伐したMobの最大体力に応じて、貢献度ポイントが蓄積されます。
-  * ステージクリア時、またはエンドレスモード終了時に、貢献度に応じたアイテム報酬がドロップします。
+  * ステージクリア時、またはエンドレスモード終了時に、貢献度に応じた **アイテム報酬とYS円報酬** を獲得できます。
-  * 報酬は人数で均等割りされるのではなく、各自の **貢献度（Mobに与えたダメージ量）** に応じて按分されます。
+  * 報酬は人数で均等割りされるのではなく、各自の **貢献度（討伐したMobの最大体力を基準にしたスコア）** に応じて按分されます。
-  * 全くダメージを与えていない（貢献度0）場合は報酬は受け取れません。
+  * YS円報酬は現物通貨アイテムでは配布されず、YS-Bankの口座へAPI経由で直接入金されます。
+  * 全く討伐に貢献していない（貢献度0）場合、通常のアイテム・YS円報酬は受け取れません。
   * 報酬配布時のチャットメッセージには、実際にとどめを刺した純粋な「討伐数（キル数）」が表示されます。
+=== 通常のYS円報酬 ===
+  * フェーズ報酬・最終クリア報酬として設定されたYS円を合算し、参加者の貢献度に応じて山分けします。
+  * 通常報酬の山分け額は、YS-Bank側で設定されている最小通貨単位に合わせて計算されます。
+  * 入金完了時には、本人へ **「実際に増えた金額」と「入金後の口座残高」** がチャット表示されます。
+  * プレイヤーがオフラインの場合も報酬は消失せず、安全な入金待ちとして保存され、次回オンライン時に自動入金されます。
+=== アリーナオーナーボーナス ===
+プレイヤーが設置したアリーナを、オーナー以外のプレイヤーが通常ステージでクリアすると、そのアリーナのオーナーへYS円ボーナスが入金されます。
+^ 条件                  ^ 内容                                                                 ^
+| 対象アリーナ          | **プレイヤー設置アリーナ**のみ。運営・admin設置アリーナは対象外です  |
+| 対象となる結果        | 通常PvEステージの全フェーズをクリアした **勝利時のみ**               |
+| ボーナス基準額        | そのゲームで参加者へ実際に山分けされるYS円通常報酬の合計             |
+| ボーナス率            | 5％                                                                  |
+| オーナー本人の参加    | オーナー本人が参加者に含まれている場合、オーナーボーナスは **無効**  |
+| オーナーがオフライン  | 入金待ちとして保存され、次回オンライン時に自動入金                   |
+=== パーティリーダーボーナス ===
+有料ステージへ複数人で挑戦してクリアした場合、そのゲームの参加費を全額支払ったホストを「パーティリーダー」として、通常の取り分とは別にYS円ボーナスが加算されます。
+^ 条件                 ^ 内容                                                                                ^
+| 必要人数             | 参加者 **2人以上**                                                                  |
+| リーダー             | ゲーム開始時にアイテムまたはYS円の参加費を全額支払ったホスト                        |
+| 対象となる結果       | 通常PvEステージの全フェーズをクリアした **勝利時のみ**                              |
+| ボーナス基準額       | そのゲームで参加者へ実際に山分けされるYS円通常報酬の合計                            |
+| ボーナス率           | 10％                                                                                |
+| 無料ステージ         | 参加費を支払ったリーダーが存在しないため **対象外**                                 |
+| リーダーの貢献度が0  | 通常の貢献度報酬はありませんが、クリア条件を満たしたリーダーボーナスは受取可能です  |
+<note important>
+オーナーボーナスとリーダーボーナスは別々に判定されます。オーナー本人が自分のアリーナで参加費を支払って複数人戦をクリアした場合、**オーナーボーナスは無効**ですが、条件を満たせば**リーダーボーナスは有効**です。
+</note>
+=== ボーナス金額の計算と通知 ===
+  * **ボーナス額** = ''参加者へ山分けされるYS円通常報酬の合計 × config指定率 ÷ 100''
+  * 計算結果に小数が出た場合は、**小数部分だけを切り捨て**ます。四捨五入・切り上げは行いません。
+  * ボーナスは口座へ直接振り込まれるため、YS-Bankの最小通貨単位には丸めず、**1円単位の整数額**をそのまま入金します。
+  * 通常の貢献度山分け総額からボーナス分を差し引くことはありません。通常報酬へ別枠で上乗せされます。
+  * 入金待ち保存時と入金完了時に通知され、完了通知には **ボーナスの種類・実際の増加額・入金後残高** が表示されます。
+次の場合、オーナー／リーダーボーナスは発生しません。
+  * 敗北、時間切れ、途中終了
+  * エンドレスモード終了
+  * PvP・フラットPvP
+  * 参加者へ山分けされるYS円通常報酬の合計が0円
+  * オーナーボーナス：運営・admin設置アリーナ、またはオーナー本人が参加
+  * リーダーボーナス：ソロプレイ、または参加費が設定されていない無料ステージ
+==== ランキング機能 ====
+コマンドを実行すると、チェスト型のインベントリGUIでランキングを確認できます。
+  * **スカル表示**: ランキング上位プレイヤーがプレイヤースカルとして表示されます。
+  * **詳細な成績**: スカルにカーソルを合わせると、「順位」「クリア回数（エンドレス到達フェーズ）」「合計討伐数」「種類別討伐数（ゾンビ○体、スケルトン○体など）」が表示されます。
+  * **操作の切り替え**: GUI画面下部のボタンをクリックして、「ページ送り/戻し」や「Solo/Partyモードの切り替え」が可能です。
 ==== プレイヤーコマンド ====
@@ 行 125: / 行 227: @@
 | ''/arena join <ID>'' | 指定したIDのアリーナでのバトルに途中参加します（待機時間中のみ有効） |
 | ''/arena leave'' | 現在参加中のバトル、または待機状態から離脱します（PvPモード中に実行した場合も、低下したステータスは安全に元に戻ります） |
-| ''/arenarank <ステージID> solo/party'' | クリア回数（ウェーブ数）と総討伐数のランキングを表示します |
+| ''/arenarank <ステージ名>'' | 指定したステージのランキングGUIを開きます。**あいまい検索に対応しており、正確なID（例: stage_endless）だけでなく、名前の一部（例: endless や エンドレス）を入力するだけでも自動で該当ステージを探して表示できます** |
@@ 行 138: / 行 240: @@
 ^ コマンド ^ エイリアス ^ 説明 ^
-| ''/arena reload'' | ''/ab reload'' | コンフィグを再読み込み（予期せぬエラーでAuraSkillsのステータス低下が戻らなくなったプレイヤーの強制復旧や、スコアボードのバグの自動クリーンアップも全プレイヤーへ一斉適用されます） |
+| ''/arena reload'' | ''/ab reload'' | コンフィグを再読み込み（予期せぬエラーの強制復旧や、スコアボード等の自動クリーンアップも全プレイヤーへ一斉適用されます） |
 | ''/arena stage list'' | ''/ab stage list'' | 登録されているステージの一覧を表示 |
 | ''/arena stage delete'' | ''/ab stage delete'' | 特定のステージを削除 |
 | ''/arena forcestop <ID>'' | ''/ab forcestop <ID>'' | 指定したアリーナのバトルを強制終了させます |
 | ''/arena bypass'' | ''/ab bypass'' | アリーナの設置制限や、バトル中の保護領域制限をバイパスします |
+| ''/arena admin resetranking all'' | ''/ab admin resetranking all'' | 全てのステージのランキングを完全に初期化します |
+| ''/arena admin resetranking <ID>'' | ''/ab admin resetranking <ID>'' | 指定したステージのランキングのみを完全に初期化します |
 ==== 全体設定 (config.yml) ====
@@ 行 150: / 行 254: @@
   * **PvP（フレンドリーファイア）設定**: PvEバトル中の参加者同士の攻撃判定の有無
   * **デスペナルティ**: PvEバトル中に死亡した場合の経験値ロスト率（0に設定でロストなし）
+=== YS円クリアボーナス設定 ===
+オーナー／リーダーボーナスの割合は ''config.yml'' で指定します。既存configに項目がない場合は ''0'' として扱われ、ボーナスは無効です。
+<code yaml>
+ys-bank:
+  minimum-unit-fallback: 10
+  clear-bonuses:
+    # プレイヤー設置アリーナのオーナーボーナス率（0で無効）
+    arena-owner-percent: 10
+    # 有料の複数人戦におけるリーダーボーナス率（0で無効）
+    party-leader-percent: 5
+</code>
+設定変更後は ''/arena reload'' を実行してください。割合は0〜100％の範囲で読み込まれ、ボーナス計算で発生した小数円は切り捨てられます。
 ==== ステージIDとファイルの作成方法 ====
@@ 行 158: / 行 278: @@
 ステージを追加・変更した後は、サーバー内で /arena reload を実行すると即座に反映されます。
-==== 【超便利】HTMLジェネレーター ====
+==== HTMLジェネレーター ====
-プラグインの ''tools/'' フォルダ内に ''YSS_ArenaBattleStageGenerator.html'' が同梱されています。 ブラウザで開くだけで動作し、モダンな直感的UIを使って ''stages.yml'' 用のコードを自動生成できます。
+プラグインの ''tools/'' フォルダ内に ''YSS_ArenaBattleStageGenerator.html'' が同梱されています。ブラウザで開くだけで動作し、UIからモブの体力、移動速度、攻撃力、サイズ、特殊演出、エンドレスモードの設定などを行い、リアルタイムでYAML形式に出力できます。
-プレビューを見ながらモブの体力、移動速度、攻撃力、サイズ、特殊演出、エンドレスモードの設定などをポチポチ選ぶだけで作成でき、リアルタイムでYAML形式に出力されるため、手動で書く前にジェネレーターを活用することをおすすめします！
 ==== ステージカスタマイズ Tips ====
@@ 行 204: / 行 323: @@
 === エンチャントの設定 ===
-装備には特定のエンチャントを指定レベルで付与することができます。 HTMLジェネレーターを使うと自動で入力されますが、手動でYAMLを書く場合のエンチャント指定名称（主なもの）は以下の通りです：
+装備には特定のエンチャントを指定レベルで付与することができます。ジェネレーターを使うと自動で入力されますが、手動でYAMLを書く場合のエンチャント指定名称（主なもの）は以下の通りです：
 ^ エンチャント効果 ^ 指定名（英語） ^
@@ 行 235: / 行 354: @@
               fire_aspect: 2
 </code>

YSマイクラサーバー

ユーザ用ツール

サイト用ツール

差分

ページ用ツール