Master Data Reference of GS2-Experience

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

Master Data Format

{
  "version": "2019-01-11",
  "experienceModels": [
    {
      "name": "[string]Experience Model Name",
      "metadata": "[string?]Metadata",
      "defaultExperience": "[long]Initial Experience Value",
      "defaultRankCap": "[long]Initial value of rank cap",
      "maxRankCap": "[long]Maximum rank cap",
      "rankThreshold": {
        "metadata": "[string?]Metadata",
        "values": [
          "[long]Rank Up Experience Threshold"
        ]
      },
      "acquireActionRates": [
        {
          "name": "[string]Reward addition table name",
          "mode": "[string]Reward addition table type",
          "rates": [
            "[double]Addition amount (multiplier)"
          ],
          "bigRates": [
            "[string]Addition amount (multiplier)"
          ]
        }
      ]
    }
  ]
}

	Type	Condition	Required	Default	Value Limits	Description
version	string		✓	2019-01-11		Format version of master data
experienceModels	List<ExperienceModel>				~ 100 items	Experience Model An Experience Model is an entity that sets thresholds for the experience required to rank up, as well as the default rank cap and maximum rank cap.

Model

ExperienceModel

Experience Model

An Experience Model is an entity that sets thresholds for the experience required to rank up, as well as the default rank cap and maximum rank cap.

	Type	Required	Default	Value Limits	Description
experienceModelId	string	✓*		~ 1024 chars	Experience Model GRN * Required (system-assigned)
name	string	✓		~ 128 chars	Experience Model Name Experience model-specific name. Specified using alphanumeric characters, hyphens (-), underscores (_), and periods (.).
metadata	string			~ 2048 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.
defaultExperience	long	✓	0	0 ~ 9223372036854775805	Initial Experience Value
defaultRankCap	long	✓		0 ~ 9223372036854775805	Initial value of rank cap
maxRankCap	long	✓		0 ~ 9223372036854775805	Maximum rank cap
rankThreshold	Threshold	✓			rank-up threshold
acquireActionRates	List<AcquireActionRate>			0 ~ 100 items	List of Reward addition tables

Threshold

Rank Up Threshold

The rank-up threshold is a sequence of numbers needed to determine rank (level) from experience. If the value [10, 20] is set, experience values between 1 and 9 are rank 1, experience values between 10 and 19 are rank 2, experience values at 20 are rank 3, and no more experience values can be obtained.

	Type	Condition	Required	Default	Value Limits	Description
metadata	string				~ 2048 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.
values	List<long>		✓		1 ~ 10000 items	List of Rank Up Experience Threshold

AcquireActionRate

Reward addition table

You can adjust the amount of rewards according to the rank.

Type

Condition

Required

Default

Value Limits

Description

name

string

✓

~ 128 chars

Reward addition table name

mode

String Enum
enum {
“double”,
“big”
}

✓

“double”

Reward addition table type

Enumerator String Definition	Description
“double”	Floating point number less than 2^48
“big”	Floating point number less than 1024 digits

rates

List<double>

{mode} == “double”

✓*

1 ~ 10000 items

Amount added per rank (multiplier)

* Required if mode is “double”

bigRates

List<string>

{mode} == “big”

✓*

1 ~ 10000 items

Amount added per rank (multiplier)

* Required if mode is “big”