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

{
  "version": "2020-06-24",
  "ratingModels": [
    {
      "name": "[string]レーティングモデル名",
      "metadata": "[string?]メタデータ",
      "initialValue": "[int]レート値の初期値",
      "volatility": "[int]レート値の変動の大きさ"
    }
  ]
}
有効化条件必須デフォルト値の制限説明
version2020-06-24マスターデータのフォーマットバージョン
ratingModelsList<RatingModel>

RatingModel

レーティングモデル

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

有効化条件必須デフォルト値の制限説明
ratingModelIdstring~ 1024文字レーティングモデルGRN
namestring~ 128文字レーティングモデル名
metadatastring~ 128文字メタデータ
initialValueint1500100 ~ 10000レート値の初期値
volatilityint1001 ~ 20000レート値の変動の大きさ

AttributeRange

有効化条件必須デフォルト値の制限説明
namestring~ 128文字属性名
minint0~ 2147483646ギャザリング参加可能な属性値の最小値
maxint0~ 2147483646ギャザリング参加可能な属性値の最大値

CapacityOfRole

有効化条件必須デフォルト値の制限説明
roleNamestring“default”~ 128文字ロール名
roleAliasesList<string>[]ロール名の別名リスト
capacityint1 ~ 256募集人数
participantsList<Player>[]参加者のプレイヤー情報リスト

Attribute

有効化条件必須デフォルト値の制限説明
namestring~ 128文字属性名
valueint0~ 2147483646属性値

Player

有効化条件必須デフォルト値の制限説明
userIdstring~ 128文字ユーザーID
attributesList<Attribute>[]属性値のリスト
roleNamestring“default”~ 128文字ロール名
denyUserIdsList<string>[]参加を拒否するユーザIDリスト

GameResult

有効化条件必須デフォルト値の制限説明
rankint~ 2147483646順位
userIdstring~ 128文字ユーザーID

Ballot

有効化条件必須デフォルト値の制限説明
userIdstring~ 128文字ユーザーID
ratingNamestring~ 128文字レーティング計算に使用するレーティング名
gatheringNamestring~ 128文字投票対象のギャザリング名
numberOfPlayerint2 ~ 10参加人数

SignedBallot

有効化条件必須デフォルト値の制限説明
bodystring~ 1024文字投票用紙の署名対象のデータ
signaturestring~ 256文字投票用紙の署名

WrittenBallot

有効化条件必須デフォルト値の制限説明
ballotBallot投票用紙
gameResultsList<GameResult>投票内容。対戦結果のリスト

TimeSpan

有効化条件必須デフォルト値の制限説明
daysint0~ 365現在時刻からの日数
hoursint0~ 24現在時刻からの時間
minutesint0~ 60現在時刻からの分