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

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

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

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

モデル

RatingModel

レーティングモデル

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

有効化条件必須デフォルト値の制限説明
ratingModelIdstring
✓*
~ 1024文字レーティングモデル GRN
※ サーバー側で自動的に設定
namestring
~ 128文字レーティングモデル名
metadatastring~ 128文字メタデータ
initialValueint
1500100 ~ 10000レート値の初期値
volatilityint
1001 ~ 20000レート値の変動の大きさ

SeasonModel

シーズンモデル

有効化条件必須デフォルト値の制限説明
seasonModelIdstring
✓*
~ 1024文字レーティングモデル GRN
※ サーバー側で自動的に設定
namestring
~ 128文字シーズンモデル名
metadatastring~ 128文字メタデータ
maximumParticipantsint
2 ~ 1000最大参加人数
experienceModelIdstring~ 1024文字ティアーを保持する GS2-Experience の経験値モデル
challengePeriodEventIdstring
~ 1024文字シーズンの期間を設定した GS2-Schedule イベント GRN