> For the complete documentation index, see [llms.txt](/llms.txt)

# GS2-SeasonRating マスターデータリファレンス

マスターデータのフォーマットと インポートする各種モデルのリファレンス




## マスターデータのフォーマット


**JSON**
```json
{
  "version": "2024-02-23",
  "seasonModels": [
    {
      "name": "[string]シーズンモデル名",
      "metadata": "[string?]メタデータ",
      "tiers": [
        {
          "metadata": "[string?]メタデータ",
          "raiseRankBonus": "[int]ランク昇格ボーナス",
          "entryFee": "[int]参加料",
          "minimumChangePoint": "[int]最小変動ポイント",
          "maximumChangePoint": "[int]最大変動ポイント"
        }
      ],
      "experienceModelId": "[string]経験値モデルID",
      "challengePeriodEventId": "[string?]チャレンジ期間イベントID"
    }
  ]
}
```


|  | 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
| --- | --- | --- | --- | --- | --- | --- |
| version | string | | ✓ | 2024-02-23 | | マスターデータのフォーマットバージョン |
| seasonModels | [List&lt;SeasonModel&gt;](#seasonmodel) |  |  |  |  ~ 50 items | シーズンモデル<br>シーズン期間中に適用されるティアー構造とポイント変動ルールを定義するマスターデータです。<br>各ティアーごとのポイント変動範囲・参加料・ランクアップボーナスを設定し、ポイント管理に使用する Experience モデルを指定します。<br>実際のポイントおよびティアーのユーザーデータは GS2-Experience によって管理されます。 |

## モデル

### SeasonModel

シーズンモデル<br>

シーズン期間中に適用されるティアー構造とポイント変動ルールを定義するマスターデータです。<br>
各ティアーごとのポイント変動範囲・参加料・ランクアップボーナスを設定し、ポイント管理に使用する Experience モデルを指定します。<br>
実際のポイントおよびティアーのユーザーデータは GS2-Experience によって管理されます。

|  | 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
| --- | --- | --- | --- | --- | --- | --- |
| seasonModelId | string |  | ※ |  |  ~ 1024文字 | シーズンモデルGRN<br>※ サーバーが自動で設定 |
| name | string |  | ✓ |  |  ~ 128文字 | シーズンモデル名<br>シーズンモデル固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。 |
| metadata | string |  |  |  |  ~ 128文字 | メタデータ<br>メタデータには任意の値を設定できます。<br>これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。 |
| tiers | [List&lt;TierModel&gt;](#tiermodel) |  | ✓ |  | 1 ~ 100 items | ティアーモデルのリスト<br>シーズンのランキングラダーを構成するティアー定義の順序付きリスト。<br>各ティアーは独自のポイント変動ルール（参加料、最小/最大変動量、昇格ボーナス）を定義します。<br>プレイヤーは GS2-Experience で管理される累積ポイントに基づいてティアーを進行します。<br>最小1ティアー、最大100ティアー。 |
| experienceModelId | string |  | ✓ |  |  ~ 1024文字 | 経験値モデルID<br>シーズンポイントとティアー進行の管理に使用する GS2-Experience 経験値モデルの GRN。<br>経験値モデルのランク閾値がティアー境界を決定し、経験値がプレイヤーの現在のシーズンポイントを表します。<br>対戦結果によるポイント変動はこの経験値モデルに適用されます。 |
| challengePeriodEventId | string |  |  |  |  ~ 1024文字 | チャレンジ期間イベントID<br>シーズンが対戦可能な期間を定義する GS2-Schedule イベントの GRN。<br>設定した場合、参照先のイベントがアクティブな間のみプレイヤーは対戦に参加できます。<br>未設定の場合、シーズンに期間制限はありません。 |

---

### TierModel

ティアーモデル<br>

ティアーモデルは、シーズン内の各ティアーにおけるポイント変動ルールを定義するモデルです。<br>
順位に応じたポイント変動範囲、参加料、昇格時ボーナスを設定します。<br>
ポイントの実データは GS2-Experience によって管理されますが、その増減ロジックは TierModel の設定に基づいて決定されます。

|  | 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
| --- | --- | --- | --- | --- | --- | --- |
| metadata | string |  |  |  |  ~ 128文字 | メタデータ<br>メタデータには任意の値を設定できます。<br>これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。 |
| raiseRankBonus | int |  | ✓ |  | 0 ~ 10000 | ランク昇格ボーナス<br>プレイヤーがこのティアーに昇格した際に加算されるボーナスポイントで、即座の降格を防ぐバッファとして機能します。<br>例えば 100 に設定すると、昇格閾値より100ポイント多い状態で新ティアーを開始します。<br>有効範囲: 0〜10000。 |
| entryFee | int |  | ✓ |  | 0 ~ 10000 | 参加料<br>対戦開始前にプレイヤーから差し引かれる参加コストとしてのポイント。<br>この参加料は対戦結果に関わらず常に減算され、対戦プレイにリスク要素を生み出します。<br>有効範囲: 0〜10000。 |
| minimumChangePoint | int |  | ✓ |  | -99999999 ~ -1 | 最小変動ポイント<br>1回の対戦結果で発生しうる最小（最も負の）ポイント変動量で、通常は最悪の敗北時の値を表します。<br>負の値である必要があります。敗北プレイヤーの実際のポイント変動はこの値と0の間になります。<br>有効範囲: -99999999〜-1。 |
| maximumChangePoint | int |  | ✓ |  | 1 ~ 99999999 | 最大変動ポイント<br>1回の対戦結果で発生しうる最大（最も正の）ポイント変動量で、通常は最高の勝利時の値を表します。<br>正の値である必要があります。勝利プレイヤーの実際のポイント変動は0とこの値の間になります。<br>有効範囲: 1〜99999999。 |

---