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

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

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

{
  "version": "2023-12-25",
  "gradeModels": [
    {
      "name": "[string]グレードモデル名",
      "metadata": "[string?]メタデータ",
      "defaultGrades": [
        {
          "propertyIdRegex": "[string]デフォルト値を適用するプロパティIDの正規表現",
          "defaultGradeValue": "[long]デフォルトのグレード値"
        }
      ],
      "experienceModelId": "[string]グレードとランクキャップを連動させる経験値モデルGRN",
      "gradeEntries": [
        {
          "metadata": "[string?]メタデータ",
          "rankCapValue": "[long]GS2-Experience に設定するランクキャップ値",
          "propertyIdRegex": "[string]プロパティIDからグレードアップに使用可能なリソースを特定するための変数を取り出すための正規表現",
          "gradeUpPropertyIdRegex": "[string]グレードアップに利用可能なリソースのプロパティIDの正規表現"
        }
      ],
      "acquireActionRates": [
        {
          "name": "[string]報酬加算テーブル名",
          "mode": "[string]報酬加算テーブルの種類",
          "rates": [
            "[double]加算量(倍率)"
          ],
          "bigRates": [
            "[string]加算量(倍率)"
          ]
        }
      ]
    }
  ]
}
有効化条件必須デフォルト値の制限説明
versionstring
2023-12-25マスターデータのフォーマットバージョン
gradeModelsList<GradeModel>~ 100 itemsグレードモデル
グレードモデルとは、キャラクターや装備のランクを示すエンティティで、グレードによって GS2-Experience のランクキャップを設定することができます。

モデル

GradeModel

グレードモデル

グレードモデルとは、キャラクターや装備のランクを示すエンティティで、グレードによって GS2-Experience のランクキャップを設定することができます。

有効化条件必須デフォルト値の制限説明
gradeModelIdstring
~ 1024文字グレードモデルGRN
namestring
~ 128文字グレードモデル名
metadatastring~ 2048文字メタデータ
defaultGradesList<DefaultGradeModel>0 ~ 100 itemsデフォルトグレードモデルリスト
experienceModelIdstring
~ 1024文字グレードとランクキャップを連動させる経験値モデルGRN
gradeEntriesList<GradeEntryModel>
1 ~ 100 itemsグレードエントリリスト
acquireActionRatesList<AcquireActionRate>0 ~ 100 items報酬加算テーブルリスト

DefaultGradeModel

デフォルトグレードモデル

グレードを新規作成する際にプロパティIDの正規表現へのマッチに応じてデフォルトのグレード値を設定することができます。

有効化条件必須デフォルト値の制限説明
propertyIdRegexstring
~ 1024文字デフォルト値を適用するプロパティIDの正規表現
defaultGradeValuelong
0 ~ 9223372036854775805デフォルトのグレード値

GradeEntryModel

グレードエントリ

有効化条件必須デフォルト値の制限説明
metadatastring~ 2048文字メタデータ
rankCapValuelong
0 ~ 9223372036854775805GS2-Experience に設定するランクキャップ値
propertyIdRegexstring
~ 1024文字プロパティIDからグレードアップに使用可能なリソースを特定するための変数を取り出すための正規表現
パターン内で括弧で囲まれた部分を gradeUpPropertyIdRegex の正規表現で $1/$2… として利用することができます。
gradeUpPropertyIdRegexstring
~ 1024文字グレードアップに利用可能なリソースのプロパティIDの正規表現

AcquireActionRate

報酬加算テーブルマスター

グレードに応じて報酬の量を調整することができます。

有効化条件必須デフォルト値の制限説明
namestring
~ 128文字報酬加算テーブル名
mode文字列列挙型
enum {
    “double”,
    “big”
}
“double”報酬加算テーブルの種類
定義説明
“double”2^48 未満の浮動小数点数
“big”文字列表記で1024桁未満の浮動小数点数
ratesList<double>{mode} == “double”
✓*
1 ~ 1000 itemsグレードごとの加算量(倍率)
※ mode が “double” であれば 必須
bigRatesList<string>{mode} == “big”
✓*
1 ~ 1000 itemsグレードごとの加算量(倍率)
※ mode が “big” であれば 必須