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

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

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

{
  "version": "2024-02-23",
  "seasonModels": [
    {
      "name": "[string]シーズンモデル名",
      "metadata": "[string?]メタデータ",
      "tiers": [
        {
          "metadata": "[string?]メタデータ",
          "raiseRankBonus": "[int]ランク昇格時にすぐにランク降格を防ぐために加算するボーナスポイント",
          "entryFee": "[int]ゲームを開始するための参加料として減算するポイント",
          "minimumChangePoint": "[int]負けた際のポイント変動量の最小値",
          "maximumChangePoint": "[int]勝った際のポイント変動量の最大値"
        }
      ],
      "experienceModelId": "[string]シーズンポイント管理に使用する GS2-Experience 経験値モデルGRN",
      "challengePeriodEventId": "[string?]シーズンの期間を設定した GS2-Schedule イベントGRN"
    }
  ]
}
有効化条件必須デフォルト値の制限説明
versionstring
2024-02-23マスターデータのフォーマットバージョン
seasonModelsList<SeasonModel>~ 50 itemsシーズンモデル
シーズン期間中に適用されるティアー構造とポイント変動ルールを定義するマスターデータです。
各ティアーごとのポイント変動範囲・参加料・ランクアップボーナスを設定し、ポイント管理に使用する Experience モデルを指定します。
実際のポイントおよびティアーのユーザーデータは GS2-Experience によって管理されます。

モデル

SeasonModel

シーズンモデル

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

有効化条件必須デフォルト値の制限説明
seasonModelIdstring
~ 1024文字シーズンモデル GRN
※ サーバーが自動で設定
namestring
~ 128文字シーズンモデル名
シーズンモデル固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。
metadatastring~ 128文字メタデータ
メタデータには任意の値を設定できます。
これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。
tiersList<TierModel>
1 ~ 100 itemsティアーモデルのリスト
experienceModelIdstring
~ 1024文字シーズンポイント管理に使用する GS2-Experience 経験値モデル GRN
challengePeriodEventIdstring~ 1024文字シーズンの期間を設定した GS2-Schedule イベント GRN

TierModel

ティアーモデル

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

有効化条件必須デフォルト値の制限説明
metadatastring~ 128文字メタデータ
メタデータには任意の値を設定できます。
これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。
raiseRankBonusint
0 ~ 10000ランク昇格時にすぐにランク降格を防ぐために加算するボーナスポイント
entryFeeint
0 ~ 10000ゲームを開始するための参加料として減算するポイント
minimumChangePointint
-99999999 ~ -1負けた際のポイント変動量の最小値
maximumChangePointint
1 ~ 99999999勝った際のポイント変動量の最大値