Master Data Reference of GS2-Matchmaking

{
  "version": "2020-06-24",
  "ratingModels": [
    {
      "name": "[string]Rating Model Name",
      "metadata": "[string?]metadata",
      "initialValue": "[int]Initial value of rate value",
      "volatility": "[int]Magnitude of rate value fluctuation"
    }
  ]
}

	Type	Condition	Require	Default	Limitation	Description
version	✓		2020-06-24	Format version of master data
ratingModels	List<RatingModel>

RatingModel

Rating Model

GS2 uses Glicko-2 as its rating algorithm. Glicko-2 has several parameters, but GS2-Matchmaking aggregates them into a single parameter, volatility, which represents the totality of the parameters. Volatility is a parameter that expresses the magnitude of change; the larger the value, the greater the change in the rating value.

	Type	Require	Default	Limitation	Description
ratingModelId	string	✓		~ 1024 chars	Rating Model GRN
name	string	✓		~ 128 chars	Rating Model Name
metadata	string			~ 128 chars	metadata
initialValue	int	✓	1500	100 ~ 10000	Initial value of rate value
volatility	int	✓	100	1 ~ 20000	Magnitude of rate value fluctuation

AttributeRange

	Type	Require	Default	Limitation	Description
name	string	✓		~ 128 chars	Attribute Name
min	int	✓	0	~ 2147483646	Minimum attribute values that can participate in the Gathering
max	int	✓	0	~ 2147483646	Maximum value of attributes that can participate in the Gathering

CapacityOfRole

	Type	Require	Default	Limitation	Description
roleName	string	✓	“default”	~ 128 chars	Role Name
roleAliases	List<string>		[]	~ 9 items	List of Role Name Aliases
capacity	int	✓		1 ~ 256	Number of applicants
participants	List<Player>		[]	~ 1000 items	List of Participant Players

Attribute

	Type	Condition	Require	Default	Limitation	Description
name	string		✓		~ 128 chars	Attribute Name
value	int		✓	0	~ 2147483646	Attribute value

Player

	Type	Require	Default	Limitation	Description
userId	string	✓		~ 128 chars	User Id
attributes	List<Attribute>		[]	~ 5 items	List of Attributes
roleName	string	✓	“default”	~ 128 chars	Role Name
denyUserIds	List<string>		[]	~ 100 items	List of user IDs that are denied participation

GameResult

	Type	Condition	Require	Default	Limitation	Description
rank	int		✓		~ 2147483646	Rank
userId	string		✓		~ 128 chars	User Id

Ballot

	Type	Require	Limitation	Description
userId	string	✓	~ 128 chars	User Id
ratingName	string	✓	~ 128 chars	Rating name used for rating calculations
gatheringName	string	✓	~ 128 chars	Name of Gathering to be voted
numberOfPlayer	int	✓	2 ~ 10	Number of participants

SignedBallot

	Type	Condition	Require	Default	Limitation	Description
body	string		✓		~ 1024 chars	Data for ballot signature targets
signature	string		✓		~ 256 chars	Signature

WrittenBallot

	Type	Condition	Require	Default	Limitation	Description
ballot	Ballot		✓			Ballot
gameResults	List<GameResult>				~ 10 items	List of Results

TimeSpan

	Type	Require	Limitation	Description
days	int	✓	~ 365	Number of days from current time
hours	int	✓	~ 24	Hours from current time
minutes	int	✓	~ 60	Minutes from current time