Master Data Reference of GS2-Matchmaking

Reference of the format of master data and various models to be imported

Master Data Format

{
  "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"
    }
  ],
  "seasonModels": [
    {
      "name": "[string]Season Model Name",
      "metadata": "[string?]Metadata",
      "maximumParticipants": "[int]Maximum number of participants",
      "experienceModelId": "[string?]GS2-Experience Experience model GRN that manages tiers",
      "challengePeriodEventId": "[string]GS2-Schedule event GRN that sets the period during which the season is open."
    }
  ]
}

	Type	Required	Default	Value Limits	Description
version	string	✓	2020-06-24		Format version of master data
ratingModels	List<RatingModel>			~ 50 items	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.
seasonModels	List<SeasonModel>			~ 50 items	Season Model

Model

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	Required	Default	Value Limits	Description
ratingModelId	string	✓*		~ 1024 chars	Rating Model GRN * Automatically configured on the server
name	string	✓		~ 128 chars	Rating Model Name Rating Model-specific name. Specified using alphanumeric characters, hyphens (-), underscores (_), and periods (.).
metadata	string			~ 128 chars	Metadata Arbitrary values can be set in the metadata. Since they do not affect GS2’s behavior, they can be used to store information used in the game.
initialValue	int	✓	1500	100 ~ 10000	Initial value of rate value
volatility	int	✓	100	1 ~ 20000	Magnitude of rate value fluctuation

SeasonModel

Season Model

	Type	Required	Value Limits	Description
seasonModelId	string	✓*	~ 1024 chars	Season Model GRN * Automatically configured on the server
name	string	✓	~ 128 chars	Season Model Name Season Model-specific name. Specified using alphanumeric characters, hyphens (-), underscores (_), and periods (.).
metadata	string		~ 128 chars	Metadata Arbitrary values can be set in the metadata. Since they do not affect GS2’s behavior, they can be used to store information used in the game.
maximumParticipants	int	✓	2 ~ 1000	Maximum number of participants
experienceModelId	string		~ 1024 chars	GS2-Experience Experience model GRN that manages tiers
challengePeriodEventId	string	✓	~ 1024 chars	GS2-Schedule event GRN that sets the period during which the season is open.