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バランスパラメータモデル
バランスパラメータの抽選条件を定義します。
バランスパラメータは固定の合計値を複数のパラメータスロットに分配します。例えば、合計パワーが100の武器に対して ATK=60、DEF=30、SPD=10 のように配分されます。初期値の設定方針により値の割り当て方法が決まります:average は均等に分配し、lottery は合計値をランダムに配分します。
rarityParameterModelsList<RarityParameterModel>~ 10000 itemsレアリティパラメータモデル
レアリティパラメータの抽選条件を定義します。レアリティパラメータは重み付き抽選システムを使用して、付与されるパラメータの数と割り当てられる具体的な値の両方を決定します。まず、付与数モデルのリストから重み付き抽選により埋めるパラメータスロット数が決定されます。次に、各スロットの値がパラメータ値モデルのリストから重み付き抽選で選択され、制御された確率分布によるランダムな装備属性を提供します。

モデル

BalanceParameterModel

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

バランスパラメータの抽選条件を定義します。
バランスパラメータは固定の合計値を複数のパラメータスロットに分配します。例えば、合計パワーが100の武器に対して ATK=60、DEF=30、SPD=10 のように配分されます。初期値の設定方針により値の割り当て方法が決まります:average は均等に分配し、lottery は合計値をランダムに配分します。

有効化条件必須デフォルト値の制限説明
balanceParameterModelIdstring
~ 1024文字バランスパラメータモデル GRN
※ サーバーが自動で設定
namestring
~ 128文字バランスパラメータモデル名
バランスパラメータモデル固有の名前。英数字および -(ハイフン) _(アンダースコア) .(ピリオド)で指定します。
metadatastring~ 2048文字メタデータ
メタデータには任意の値を設定できます。
これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。
totalValuelong
0 ~ 9223372036854775805合計値
すべてのパラメータスロットに分配される固定の合計値です。パラメータが抽選される際、使用される配分方針に関わらず、個々の値の合計は常にこの合計値になります。
initialValueStrategy文字列列挙型
enum {
  “average”,
  “lottery”
}
“average”初期値の設定方針
初回割り当て時に合計値をパラメータスロットにどのように分配するかを決定します。average は合計値をすべてのパラメータに均等に分配し、lottery は合計値をランダムに分配してバラエティに富んだパラメータの組み合わせを作成します。
定義説明
“average”平均値
“lottery”抽選
parametersList<BalanceParameterValueModel>
1 ~ 10 itemsバランスパラメータ値モデルのリスト
このバランスパラメータで利用可能なパラメータスロットを定義します。各エントリは名前付きパラメータスロット(例: ATK、DEF、SPD)をオプションのメタデータとともに指定します。合計値はこれらのスロットに分配されます。

BalanceParameterValueModel

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

バランスパラメータ内で利用可能な単一のパラメータスロットを定義します。各エントリは、抽選処理中に合計値の一部を受け取る名前付きスロット(例: ATK、DEF、SPD)を指定します。

有効化条件必須デフォルト値の制限説明
namestring
~ 64文字名前
このパラメータスロットの識別子(例: ATK、DEF、SPD)です。バランスパラメータモデル内で一意である必要があります。抽選されたパラメータ値の保存・取得時にキーとして使用されます。
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付与数
このエントリが抽選された際に付与するパラメータスロット数です。例えば、付与数が 3 の場合、リソースは値モデルプールから選択された 3 つのパラメータ値を受け取ります。
weightint
1 ~ 2147483646排出重み
パラメータ付与数を決定する重み付き抽選で使用される相対的な重みです。値が大きいほど、この付与数が選択される確率が高くなります。実際の確率は、この重みを付与数モデルリスト内のすべての重みの合計で割った値になります。

RarityParameterValueModel

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

レアリティパラメータ値の重み付き抽選プール内の単一エントリを定義します。各エントリはパラメータ名、ゲーム定義のリソース詳細、およびプール内の他のエントリに対する選択確率を決定する排出重みを指定します。

有効化条件必須デフォルト値の制限説明
namestring
~ 64文字名前
この抽選エントリの識別子です。レアリティパラメータモデルの値プール内で一意である必要があります。抽選された際、この名前が結果のレアリティパラメータ値に保存されます。
metadatastring~ 512文字メタデータ
メタデータには任意の値を設定できます。
これらの値は GS2 の動作には影響しないため、ゲーム内で利用する情報の保存先として使用できます。
resourceNamestring
~ 64文字ゲーム内で使用するパラメータリソースの種類を表す名前(GS2の動作のためには使用しません)
このパラメータ値に関連付けられたゲーム定義のリソース種別名(例: “fire_attack”、“ice_resist”)です。GS2 はこの値を自身の動作には使用せず、抽選結果にそのまま渡されゲームロジックで使用されます。
resourceValuelong
0 ~ 9223372036854775805ゲーム内で使用するパラメータリソースの値(GS2の動作のためには使用しません)
このパラメータのゲーム定義の数値(例: 攻撃力+50 の場合は 50)です。GS2 はこの値を自身の動作には使用せず、抽選結果にそのまま渡されゲームロジックで使用されます。
weightint
1 ~ 2147483646排出重み
パラメータ値を選択する重み付き抽選で使用される相対的な重みです。値が大きいほど、このエントリが選択される確率が高くなります。実際の確率は、この重みをプール内のすべての重みの合計で割った値になります。