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

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

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

{
  "version": "2020-06-24",
  "ratingModels": [
    {
      "name": "[string]レーティングモデル名",
      "metadata": "[string?]メタデータ",
      "initialValue": "[int]レート値の初期値",
      "volatility": "[int]レーティングのボラティリティ"
    }
  ],
  "seasonModels": [
    {
      "name": "[string]シーズンモデル名",
      "metadata": "[string?]メタデータ",
      "maximumParticipants": "[int]最大参加人数",
      "experienceModelId": "[string?]ティアー管理用の経験値モデルGRN",
      "challengePeriodEventId": "[string]チャレンジ期間イベントGRN"
    }
  ]
}
有効化条件必須デフォルト値の制限説明
versionstring
2020-06-24マスターデータのフォーマットバージョン
ratingModelsList<RatingModel>~ 50 itemsレーティングモデル
GS2 ではレーティングアルゴリズムとして Glicko-2 を採用しています。
Glicko-2 には複数のパラメータがありますが、GS2-Matchmaking ではそれらを総合的に表す ボラティリティ という1つのパラメータに集約しています。
ボラティリティ は変化の大きさを表すパラメータで、値が大きいほどレーティングの値の変動量が大きくなります。
seasonModelsList<SeasonModel>~ 50 itemsシーズンモデル
シーズンマッチメイキングにおいて、一定期間有効な永続ギャザリングの期間・最大参加人数・ティアー連携設定を定義するマスターデータです。
GS2-Schedule により期間を管理し、必要に応じて GS2-Experience と連携して同一ティアー内で永続ギャザリングを形成します。

モデル

RatingModel

レーティングモデル

GS2 ではレーティングアルゴリズムとして Glicko-2 を採用しています。
Glicko-2 には複数のパラメータがありますが、GS2-Matchmaking ではそれらを総合的に表す ボラティリティ という1つのパラメータに集約しています。
ボラティリティ は変化の大きさを表すパラメータで、値が大きいほどレーティングの値の変動量が大きくなります。

有効化条件必須デフォルト値の制限説明
ratingModelIdstring
~ 1024文字レーティングモデル GRN
※ サーバーが自動で設定
namestring
~ 128文字レーティングモデル名
レーティングモデル固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。
metadatastring~ 128文字メタデータ
メタデータには任意の値を設定できます。
これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。
initialValueint1500100 ~ 10000レート値の初期値
プレイヤーが初めてレーティング付きマッチメイキングに参加したときに割り当てられる開始レート値。
デフォルトは 1500 です。すべてのプレイヤーは同じレーティングから開始し、対戦結果に基づいて調整されます。
volatilityint1001 ~ 20000レーティングのボラティリティ
各対戦後にレート値がどの程度変動するかを制御する Glicko-2 のパラメータ。
値が大きいほどレーティングの変動幅が大きくなり、より早くレーティングが調整されます。
値が小さいほどレーティングが安定し、緩やかに変化します。デフォルトは 100 です。

SeasonModel

シーズンモデル

シーズンマッチメイキングにおいて、一定期間有効な永続ギャザリングの期間・最大参加人数・ティアー連携設定を定義するマスターデータです。
GS2-Schedule により期間を管理し、必要に応じて GS2-Experience と連携して同一ティアー内で永続ギャザリングを形成します。

有効化条件必須デフォルト値の制限説明
seasonModelIdstring
~ 1024文字シーズンモデル GRN
※ サーバーが自動で設定
namestring
~ 128文字シーズンモデル名
シーズンモデル固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。
metadatastring~ 128文字メタデータ
メタデータには任意の値を設定できます。
これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。
maximumParticipantsint
2 ~ 1000最大参加人数
1つのシーズンギャザリングに参加可能なプレイヤーの最大人数。
この上限に達するとシーズンギャザリングは満員となり、それ以上のプレイヤーは参加できなくなります。
2 から 1000 の範囲で指定します。
experienceModelIdstring~ 1024文字ティアー管理用の経験値モデル GRN
プレイヤーのティアーを決定するために使用する GS2-Experience の経験値モデルの GRN。
この経験値モデルにおけるプレイヤーのランクがマッチメイキングのティアーとして使用され、同程度のレベルのプレイヤー同士がグルーピングされます。
未指定の場合、ティアーによるグルーピングは無効となり、レベルに関係なく全プレイヤーがマッチングされます。
challengePeriodEventIdstring
~ 1024文字チャレンジ期間イベント GRN
このシーズンの有効期間を定義する GS2-Schedule イベントの GRN。
このイベントがアクティブな間のみ、シーズンギャザリングの作成・参加が可能です。
イベント期間が終了するとシーズンがクローズし、新しいマッチメイキングはできなくなります。