Master Data Reference of GS2-SeasonRating

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

Master Data Format

{
  "version": "2024-02-23",
  "seasonModels": [
    {
      "name": "[string]Season Model Name",
      "metadata": "[string?]Metadata",
      "tiers": [
        {
          "metadata": "[string?]Metadata",
          "raiseRankBonus": "[int]The bonus points added to prevent immediate rank demotion when the rank is promoted.",
          "entryFee": "[int]Points to be subtracted as an entry fee to start the game.",
          "minimumChangePoint": "[int]Change point minimum value when losing",
          "maximumChangePoint": "[int]Change point maximum value when winning"
        }
      ],
      "experienceModelId": "[string]Experience Model GRN",
      "challengePeriodEventId": "[string?]GS2-Schedule event GRN that sets the period during which the season is open."
    }
  ]
}
TypeConditionRequiredDefaultValue LimitsDescription
versionstring
2024-02-23Format version of master data
seasonModelsList<SeasonModel>~ 50 itemsSeason 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.

Model

SeasonModel

Season 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.

TypeConditionRequiredDefaultValue LimitsDescription
seasonModelIdstring
✓*
~ 1024 charsSeason Model GRN
* Automatically configured on the server
namestring
~ 128 charsSeason Model Name
Season Model-specific name. Specified using alphanumeric characters, hyphens (-), underscores (_), and periods (.).
metadatastring~ 128 charsMetadata
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.
tiersList<TierModel>
1 ~ 100 itemsList of Tier
experienceModelIdstring
~ 1024 charsExperience Model GRN
challengePeriodEventIdstring~ 1024 charsGS2-Schedule event GRN that sets the period during which the season is open.

TierModel

Tier Model

TypeConditionRequiredDefaultValue LimitsDescription
metadatastring~ 128 charsMetadata
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.
raiseRankBonusint
0 ~ 10000The bonus points added to prevent immediate rank demotion when the rank is promoted.
entryFeeint
0 ~ 10000Points to be subtracted as an entry fee to start the game.
minimumChangePointint
-99999999 ~ -1Change point minimum value when losing
maximumChangePointint
1 ~ 99999999Change point maximum value when winning