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."
}
]
}| Type | Condition | Required | Default | Value Limits | Description | |
|---|---|---|---|---|---|---|
| version | string | ✓ | 2024-02-23 | Format version of master data | ||
| seasonModels | List<SeasonModel> | ~ 50 items | 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. |
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.
| Type | Condition | Required | Default | 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. | |||
| tiers | List<TierModel> | ✓ | 1 ~ 100 items | List of Tier | ||
| experienceModelId | string | ✓ | ~ 1024 chars | Experience Model GRN | ||
| challengePeriodEventId | string | ~ 1024 chars | GS2-Schedule event GRN that sets the period during which the season is open. |
TierModel
Tier Model
| Type | Condition | Required | Default | Value Limits | Description | |
|---|---|---|---|---|---|---|
| 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. | |||
| raiseRankBonus | int | ✓ | 0 ~ 10000 | The bonus points added to prevent immediate rank demotion when the rank is promoted. | ||
| entryFee | int | ✓ | 0 ~ 10000 | Points to be subtracted as an entry fee to start the game. | ||
| minimumChangePoint | int | ✓ | -99999999 ~ -1 | Change point minimum value when losing | ||
| maximumChangePoint | int | ✓ | 1 ~ 99999999 | Change point maximum value when winning |