Master Data Reference of GS2-Enchant

{
  "version": "2023-07-18",
  "balanceParameterModels": [
    {
      "name": "[string]Balance parameter model name",
      "metadata": "[string?]metadata",
      "totalValue": "[long]Total value",
      "initialValueStrategy": "[string]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]Value",
          "weight": "[int]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]Weight"
        }
      ]
    }
  ]
}
TypeConditionRequireDefaultLimitationDescription
version2023-07-18Format version of master data
balanceParameterModelsList<BalanceParameterModel>~ 10000 itemsBalance parameter model
rarityParameterModelsList<RarityParameterModel>~ 10000 itemsBalance parameter model

BalanceParameterModel

Balance parameter model

Defines the drawing conditions for balance parameters.

TypeConditionRequireDefaultLimitationDescription
balanceParameterModelIdstring~ 1024 charsBalance Parameter Model GRN
namestring~ 128 charsBalance parameter model name
metadatastring~ 2048 charsmetadata
totalValuelong~ 9223372036854775805Total value
initialValueStrategyenum {
    “average”,
    “lottery”
}
“average”~ 128 charsInitial value setting policy
parametersList<BalanceParameterValueModel>1 ~ 10 itemsBalance parameter value model list

Enumeration type definition to specify as initialValueStrategy

Enumerator String DefinitionDescription
averageAverage
lotteryLottery

RarityParameterModel

Balance parameter model

Defines the drawing conditions for balance parameters.

TypeConditionRequireDefaultLimitationDescription
rarityParameterModelIdstring~ 1024 charsRarity Parameter Model GRN
namestring~ 128 charsRarity parameter model name
metadatastring~ 2048 charsmetadata
maximumParameterCountint1 ~ 10Maximum number of parameters to be given
parameterCountsList<RarityParameterCountModel>1 ~ 10 itemsRarity parameter value model list
parametersList<RarityParameterValueModel>1 ~ 1000 itemsRarity parameter value model list

BalanceParameterValueModel

Balance Parameter Value Model

TypeConditionRequireDefaultLimitationDescription
namestring~ 64 charsName
metadatastring~ 512 charsmetadata

RarityParameterCountModel

Model of the number of rarity parameters granted

TypeConditionRequireDefaultLimitationDescription
countint~ 10Value
weightint1 ~ 2147483646Weight

RarityParameterValueModel

Balance Parameter Value Model

TypeConditionRequireDefaultLimitationDescription
namestring~ 64 charsName
metadatastring~ 512 charsmetadata
resourceNamestring~ 64 charsParameter Resource Name for Game(Not used for GS2)
resourceValuelong~ 9223372036854775805Parameter Resource Value for Game(Not used for GS2)
weightint1 ~ 2147483646Weight

BalanceParameterValue

Balance Parameter Value Model

TypeConditionRequireDefaultLimitationDescription
namestring~ 64 charsName
valuelong~ 9223372036854775805Value

RarityParameterValue

Rarity Parameter Value Model

TypeConditionRequireDefaultLimitationDescription
namestring~ 64 charsName
resourceNamestring~ 64 charsResource Name
resourceValuelong~ 9223372036854775805Resource Value

VerifyActionResult

Verify action execution result

TypeConditionRequireDefaultLimitationDescription
actionenum {
}
~ 128 charsTypes of actions to be performed in the verify task
verifyRequeststring~ 1048576 charsJSON of request
statusCodeint~ 999Status code
verifyResultstring~ 1048576 charsResult payload

Enumeration type definition to specify as action

Enumerator String DefinitionDescription

ConsumeActionResult

Consume action execution result

TypeConditionRequireDefaultLimitationDescription
actionenum {
}
~ 128 charsTypes of actions to be performed in the consume action
consumeRequeststring~ 1048576 charsJSON of request
statusCodeint~ 999Status code
consumeResultstring~ 1048576 charsResult payload

Enumeration type definition to specify as action

Enumerator String DefinitionDescription

AcquireActionResult

Acquire action execution result

TypeConditionRequireDefaultLimitationDescription
actionenum {
}
~ 128 charsTypes of actions to be performed in the acquire action
acquireRequeststring~ 1048576 charsJSON of request
statusCodeint~ 999Status code
acquireResultstring~ 1048576 charsResult payload

Enumeration type definition to specify as action

Enumerator String DefinitionDescription

TransactionResult

Transaction execution results

Transaction execution results executed using server-side transaction auto-execution functionality

TypeConditionRequireDefaultLimitationDescription
transactionIdstring36 ~ 36 charsTransaction ID
verifyResultsList<VerifyActionResult>~ 10 itemsList of verify action execution results
consumeResultsList<ConsumeActionResult>~ 10 itemsList of consume action execution results
acquireResultsList<AcquireActionResult>~ 100 itemsList of acquire action execution results