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