GS2-Enchant Master Data Reference

Reference for the master data format and the models to be imported

Master Data Format

{
  "version": "2023-07-18",
  "balanceParameterModels": [
    {
      "name": "[string]Balance Parameter Model name",
      "metadata": "[string?]Metadata",
      "totalValue": "[long]Total value",
      "initialValueStrategy": "[string (enum)]Initial value setting policy",
      "parameters": [
        {
          "name": "[string]Name",
          "metadata": "[string?]Metadata"
        }
      ]
    }
  ],
  "rarityParameterModels": [
    {
      "name": "[string]Rarity Parameter Model name",
      "metadata": "[string?]Metadata",
      "maximumParameterCount": "[int]Maximum number of parameters to be given",
      "parameterCounts": [
        {
          "count": "[int]Count",
          "weight": "[int]Draw Weight"
        }
      ],
      "parameters": [
        {
          "name": "[string]Name",
          "metadata": "[string?]Metadata",
          "resourceName": "[string]Parameter Resource Name for Game (Not used for GS2)",
          "resourceValue": "[long]Parameter Resource Value for Game (Not used for GS2)",
          "weight": "[int]Draw Weight"
        }
      ]
    }
  ]
}
Type Condition Required Default Value Limits Description
version string
2023-07-18 Format version of master data
balanceParameterModels List<BalanceParameterModel> ~ 10000 items Balance Parameter Model
Defines the drawing conditions for balance parameters.
Balance parameters distribute a fixed total value across multiple parameter slots. For example, a weapon with a total power of 100 might have ATK=60, DEF=30, SPD=10. The initial value strategy determines how values are assigned: average distributes evenly, while lottery randomly allocates the total across parameters.
rarityParameterModels List<RarityParameterModel> ~ 10000 items Rarity Parameter Model
Defines the drawing conditions for rarity parameters. Rarity parameters use a weighted lottery system to determine both the number of parameters granted and the specific values assigned. First, the number of parameter slots to fill is determined by a weighted draw from the parameter count model list. Then, each slot’s value is selected by a weighted draw from the parameter value model list, providing randomized equipment attributes with controlled probability distributions.

Models

BalanceParameterModel

Balance Parameter Model

Defines the drawing conditions for balance parameters. Balance parameters distribute a fixed total value across multiple parameter slots. For example, a weapon with a total power of 100 might have ATK=60, DEF=30, SPD=10. The initial value strategy determines how values are assigned: average distributes evenly, while lottery randomly allocates the total across parameters.

Type Condition Required Default Value Limits Description
balanceParameterModelId string
*
~ 1024 chars Balance Parameter Model GRN
* Set automatically by the server
name string
~ 128 chars Balance Parameter Model name
Balance Parameter Model-specific name. Specified using alphanumeric characters, hyphen (-), underscore (_), and period (.).
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.
totalValue long
0 ~ 9223372036854775805 Total value
The fixed total that is distributed across all parameter slots. When parameters are drawn, the individual values will always sum to this total regardless of the allocation strategy used.
initialValueStrategy string (enum)
enum {
  “average”,
  “lottery”
}
“average” Initial value setting policy
Determines how the total value is distributed across parameter slots when first assigned. average divides the total evenly among all parameters, while lottery randomly distributes the total to create varied parameter combinations.
DefinitionDescription
“average”Average
“lottery”Lottery
parameters List<BalanceParameterValueModel>
1 ~ 10 items Balance parameter value model list
Defines the parameter slots available for this balance parameter. Each entry specifies a named parameter slot (e.g., ATK, DEF, SPD) with optional metadata. The total value is distributed across these slots.

BalanceParameterValueModel

Balance Parameter Value Model

Defines a single parameter slot available within a balance parameter. Each entry specifies a named slot (e.g., ATK, DEF, SPD) that receives a portion of the total value during the drawing process.

Type Condition Required Default Value Limits Description
name string
~ 64 chars Name
The identifier for this parameter slot (e.g., ATK, DEF, SPD). Must be unique within the balance parameter model. Used as the key when storing and retrieving drawn parameter values.
metadata string ~ 512 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.

RarityParameterModel

Rarity Parameter Model

Defines the drawing conditions for rarity parameters. Rarity parameters use a weighted lottery system to determine both the number of parameters granted and the specific values assigned. First, the number of parameter slots to fill is determined by a weighted draw from the parameter count model list. Then, each slot’s value is selected by a weighted draw from the parameter value model list, providing randomized equipment attributes with controlled probability distributions.

Type Condition Required Default Value Limits Description
rarityParameterModelId string
*
~ 1024 chars Rarity Parameter Model GRN
* Set automatically by the server
name string
~ 128 chars Rarity Parameter Model name
Rarity Parameter Model-specific name. Specified using alphanumeric characters, hyphen (-), underscore (_), and period (.).
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.
maximumParameterCount int
1 ~ 10 Maximum number of parameters to be given
The upper limit on the number of parameter slots that can be granted to a resource. The actual number granted is determined by a weighted draw from the parameter count model list, but will never exceed this value.
parameterCounts List<RarityParameterCountModel>
1 ~ 10 items Rarity parameter count model list
Defines the weighted lottery entries for determining how many parameter slots are granted. Each entry specifies a count and a draw weight. Higher weights increase the probability of that count being selected.
parameters List<RarityParameterValueModel>
1 ~ 1000 items Rarity parameter value model list
Defines the pool of possible parameter values that can be drawn. Each entry specifies a parameter name, resource details, and a draw weight. When filling parameter slots, values are selected from this pool via weighted lottery without replacement.

RarityParameterCountModel

Rarity Parameter Count Model

Defines a single entry in the weighted lottery for determining how many parameter slots are granted to a resource. Each entry pairs a parameter count with a draw weight, allowing fine-grained control over the probability distribution of parameter quantities.

Type Condition Required Default Value Limits Description
count int
0 ~ 10 Count
The number of parameter slots to grant when this entry is drawn. For example, a count of 3 means the resource will receive 3 parameter values selected from the value model pool.
weight int
1 ~ 2147483646 Draw Weight
The relative weight used in the weighted lottery when determining the parameter count. Higher values increase the probability of this count being selected. The actual probability is this weight divided by the sum of all weights in the count model list.

RarityParameterValueModel

Rarity Parameter Value Model

Defines a single entry in the weighted lottery pool for rarity parameter values. Each entry specifies a parameter name, game-defined resource details, and a draw weight that determines its selection probability relative to other entries in the pool.

Type Condition Required Default Value Limits Description
name string
~ 64 chars Name
The identifier for this lottery entry. Must be unique within the rarity parameter model’s value pool. When drawn, this name is stored in the resulting Rarity Parameter Value.
metadata string ~ 512 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.
resourceName string
~ 64 chars Parameter Resource Name for Game (Not used for GS2)
A game-defined resource type name associated with this parameter value (e.g., “fire_attack”, “ice_resist”). GS2 does not use this value for its own operations; it is passed through to the drawn result for use in game logic.
resourceValue long
0 ~ 9223372036854775805 Parameter Resource Value for Game (Not used for GS2)
A game-defined numeric value for this parameter (e.g., 50 for +50 attack power). GS2 does not use this value for its own operations; it is passed through to the drawn result for use in game logic.
weight int
1 ~ 2147483646 Draw Weight
The relative weight used in the weighted lottery when selecting parameter values. Higher values increase the probability of this entry being selected. The actual probability is this weight divided by the sum of all weights in the pool.