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 | ✓ | 2020-06-24 | マスターデータのフォーマットバージョン | |||
ratingModels | List<RatingModel> | ~ 50 items | レーティングモデル | |||
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 |
AttributeRange
募集条件
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
name | string | ✓ | ~ 128文字 | 属性名 | ||
min | int | ✓ | 0 | ~ 2147483646 | ギャザリング参加可能な属性値の最小値 | |
max | int | ✓ | 0 | ~ 2147483646 | ギャザリング参加可能な属性値の最大値 |
CapacityOfRole
募集枠
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
roleName | string | ✓ | “default” | ~ 128文字 | ロール名 | |
roleAliases | List<string> | [] | ~ 9 items | ロール名の別名リスト | ||
capacity | int | ✓ | 1 ~ 256 | 募集人数 | ||
participants | List<Player> | [] | ~ 1000 items | 参加者のプレイヤー情報リスト |
Attribute
属性値
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
name | string | ✓ | ~ 128文字 | 属性名 | ||
value | int | ✓ | 0 | ~ 2147483646 | 属性値 |
Player
参加者のプレイヤー情報
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
userId | string | ✓ | ~ 128文字 | ユーザーID | ||
attributes | List<Attribute> | [] | ~ 5 items | 属性値のリスト | ||
roleName | string | ✓ | “default” | ~ 128文字 | ロール名 | |
denyUserIds | List<string> | [] | ~ 100 items | 参加を拒否するユーザIDリスト | ||
createdAt | long | ✓ | 現在時刻 | 作成日時 (UNIX時間 単位:ミリ秒) |
GameResult
対戦結果
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
rank | int | ✓ | ~ 2147483646 | 順位 | ||
userId | string | ✓ | ~ 128文字 | ユーザーID |
Ballot
投票用紙
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
userId | string | ✓ | ~ 128文字 | ユーザーID | ||
ratingName | string | ✓ | ~ 128文字 | レーティング計算に使用するレーティング名 | ||
gatheringName | string | ✓ | ~ 128文字 | 投票対象のギャザリング名 | ||
numberOfPlayer | int | ✓ | 2 ~ 10 | 参加人数 |
SignedBallot
署名付の投票用紙
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
body | string | ✓ | ~ 1024文字 | 投票用紙の署名対象のデータ | ||
signature | string | ✓ | ~ 256文字 | 投票用紙の署名 |
WrittenBallot
投票用紙
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
ballot | Ballot | ✓ | 投票用紙 | |||
gameResults | List<GameResult> | ~ 10 items | 投票内容。対戦結果のリスト |
TimeSpan
時間間隔
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
days | int | ✓ | 0 | ~ 365 | 現在時刻からの日数 | |
hours | int | ✓ | 0 | ~ 24 | 現在時刻からの時間 | |
minutes | int | ✓ | 0 | ~ 60 | 現在時刻からの分 |