GS2-Enchant マスターデータリファレンス

マスターデータのフォーマットと インポートする各種モデルのリファレンス

マスターデータのフォーマット

{
  "version": "2023-07-18",
  "balanceParameterModels": [
    {
      "name": "[string]バランスパラメータモデル名",
      "metadata": "[string?]メタデータ",
      "totalValue": "[long]合計値",
      "initialValueStrategy": "[string enum]初期値の設定方針",
      "parameters": [
        {
          "name": "[string]名前",
          "metadata": "[string?]メタデータ"
        }
      ]
    }
  ],
  "rarityParameterModels": [
    {
      "name": "[string]レアリティパラメータモデル名",
      "metadata": "[string?]メタデータ",
      "maximumParameterCount": "[int]付与するパラメータの最大数",
      "parameterCounts": [
        {
          "count": "[int]値",
          "weight": "[int]排出重み"
        }
      ],
      "parameters": [
        {
          "name": "[string]名前",
          "metadata": "[string?]メタデータ",
          "resourceName": "[string]ゲーム内で使用するパラメータリソースの種類を表す名前(GS2の動作のためには使用しません)",
          "resourceValue": "[long]ゲーム内で使用するパラメータリソースの値(GS2の動作のためには使用しません)",
          "weight": "[int]排出重み"
        }
      ]
    }
  ]
}
有効化条件必須デフォルト値の制限説明
versionstring
2023-07-18マスターデータのフォーマットバージョン
balanceParameterModelsList<BalanceParameterModel>~ 10000 itemsバランスパラメータモデル
バランスパラメータの抽選条件を定義します。
rarityParameterModelsList<RarityParameterModel>~ 10000 itemsレアリティパラメータモデル
レアリティパラメータの抽選条件を定義します。

モデル

BalanceParameterModel

バランスパラメータモデル

バランスパラメータの抽選条件を定義します。

有効化条件必須デフォルト値の制限説明
balanceParameterModelIdstring
✓*
~ 1024文字バランスパラメータモデル GRN
※ サーバー側で自動的に設定
namestring
~ 128文字バランスパラメータモデル名
バランスパラメータモデル固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。
metadatastring~ 2048文字メタデータ
メタデータには任意の値を設定できます。
これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。
totalValuelong
0 ~ 9223372036854775805合計値
initialValueStrategy文字列列挙型
enum {
  “average”,
  “lottery”
}
“average”初期値の設定方針
定義説明
“average”平均値
“lottery”抽選
parametersList<BalanceParameterValueModel>
1 ~ 10 itemsバランスパラメータ値モデルのリスト

BalanceParameterValueModel

バランスパラメータ値モデル

有効化条件必須デフォルト値の制限説明
namestring
~ 64文字名前
metadatastring~ 512文字メタデータ
メタデータには任意の値を設定できます。
これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。

RarityParameterModel

レアリティパラメータモデル

レアリティパラメータの抽選条件を定義します。

有効化条件必須デフォルト値の制限説明
rarityParameterModelIdstring
✓*
~ 1024文字レアリティパラメータモデル GRN
※ サーバー側で自動的に設定
namestring
~ 128文字レアリティパラメータモデル名
レアリティパラメータモデル固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。
metadatastring~ 2048文字メタデータ
メタデータには任意の値を設定できます。
これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。
maximumParameterCountint
1 ~ 10付与するパラメータの最大数
parameterCountsList<RarityParameterCountModel>
1 ~ 10 itemsレアリティパラメータの付与数モデルのリスト
parametersList<RarityParameterValueModel>
1 ~ 1000 itemsレアリティパラメータ値モデルのリスト

RarityParameterCountModel

レアリティパラメータの付与数モデル

有効化条件必須デフォルト値の制限説明
countint
0 ~ 10
weightint
1 ~ 2147483646排出重み

RarityParameterValueModel

レアリティパラメータ値モデル

有効化条件必須デフォルト値の制限説明
namestring
~ 64文字名前
metadatastring~ 512文字メタデータ
メタデータには任意の値を設定できます。
これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。
resourceNamestring
~ 64文字ゲーム内で使用するパラメータリソースの種類を表す名前(GS2の動作のためには使用しません)
resourceValuelong
0 ~ 9223372036854775805ゲーム内で使用するパラメータリソースの値(GS2の動作のためには使用しません)
weightint
1 ~ 2147483646排出重み