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

{
  "version": "2020-06-24",
  "ratingModels": [
    {
      "name": "[string]レーティングモデル名",
      "metadata": "[string?]メタデータ",
      "initialValue": "[int]レート値の初期値",
      "volatility": "[int]レート値の変動の大きさ"
    }
  ]
}

	型	有効化条件	必須	デフォルト	値の制限	説明
version	✓		2020-06-24	マスターデータのフォーマットバージョン
ratingModels	List<RatingModel>

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	レート値の変動の大きさ

AttributeRange

	型	必須	デフォルト	値の制限	説明
name	string	✓		~ 128文字	属性名
min	int	✓	0	~ 2147483646	ギャザリング参加可能な属性値の最小値
max	int	✓	0	~ 2147483646	ギャザリング参加可能な属性値の最大値

CapacityOfRole

	型	必須	デフォルト	値の制限	説明
roleName	string	✓	“default”	~ 128文字	ロール名
roleAliases	List<string>		[]		ロール名の別名リスト
capacity	int	✓		1 ~ 256	募集人数
participants	List<Player>		[]		参加者のプレイヤー情報リスト

Attribute

	型	有効化条件	必須	デフォルト	値の制限	説明
name	string		✓		~ 128文字	属性名
value	int		✓	0	~ 2147483646	属性値

Player

	型	必須	デフォルト	値の制限	説明
userId	string	✓		~ 128文字	ユーザーID
attributes	List<Attribute>		[]		属性値のリスト
roleName	string	✓	“default”	~ 128文字	ロール名
denyUserIds	List<string>		[]		参加を拒否するユーザIDリスト

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>					投票内容。対戦結果のリスト

TimeSpan

	型	必須	値の制限	説明
days	int	✓	~ 365	現在時刻からの日数
hours	int	✓	~ 24	現在時刻からの時間
minutes	int	✓	~ 60	現在時刻からの分