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]加算量(倍率)"
          ]
        }
      ]
    }
  ]
}
有効化条件必須デフォルト値の制限説明
version2023-12-25マスターデータのフォーマットバージョン
gradeModelsList<GradeModel>~ 100 itemsグレードモデル

GradeModel

グレードモデル

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

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

DefaultGradeModel

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

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

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

GradeEntryModel

グレードエントリ

有効化条件必須デフォルト値の制限説明
metadatastring~ 2048文字メタデータ
rankCapValuelong~ 9223372036854775805GS2-Experience に設定するランクキャップ値
propertyIdRegexstring~ 1024文字プロパティIDからグレードアップに使用可能なリソースを特定するための変数を取り出すための正規表現
gradeUpPropertyIdRegexstring~ 1024文字グレードアップに利用可能なリソースのプロパティIDの正規表現

AcquireActionRate

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

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

有効化条件必須デフォルト値の制限説明
namestring~ 128文字報酬加算テーブル名
modeenum {
    “double”,
    “big”
}
“double”~ 128文字報酬加算テーブルの種類
ratesList<double>{mode} == “double”1 ~ 1000 itemsグレードごとの加算量(倍率)
bigRatesList<string>{mode} == “big”1 ~ 1000 itemsグレードごとの加算量(倍率)

mode に指定する列挙型の定義

定義説明
double2^48 未満の浮動小数点数
big文字列表記で1024桁未満の浮動小数点数

AcquireAction

入手アクション

有効化条件必須デフォルト値の制限説明
actionenum {
"Gs2AdReward:AcquirePointByUserId",
"Gs2Dictionary:AddEntriesByUserId",
"Gs2Enchant:ReDrawBalanceParameterStatusByUserId",
"Gs2Enchant:SetBalanceParameterStatusByUserId",
"Gs2Enchant:ReDrawRarityParameterStatusByUserId",
"Gs2Enchant:AddRarityParameterStatusByUserId",
"Gs2Enchant:SetRarityParameterStatusByUserId",
"Gs2Enhance:DirectEnhanceByUserId",
"Gs2Enhance:UnleashByUserId",
"Gs2Enhance:CreateProgressByUserId",
"Gs2Exchange:ExchangeByUserId",
"Gs2Exchange:IncrementalExchangeByUserId",
"Gs2Exchange:CreateAwaitByUserId",
"Gs2Exchange:AcquireForceByUserId",
"Gs2Exchange:SkipByUserId",
"Gs2Experience:AddExperienceByUserId",
"Gs2Experience:SetExperienceByUserId",
"Gs2Experience:AddRankCapByUserId",
"Gs2Experience:SetRankCapByUserId",
"Gs2Experience:MultiplyAcquireActionsByUserId",
"Gs2Formation:AddMoldCapacityByUserId",
"Gs2Formation:SetMoldCapacityByUserId",
"Gs2Formation:AcquireActionsToFormProperties",
"Gs2Formation:SetFormByUserId",
"Gs2Formation:AcquireActionsToPropertyFormProperties",
"Gs2Friend:UpdateProfileByUserId",
"Gs2Grade:AddGradeByUserId",
"Gs2Grade:ApplyRankCapByUserId",
"Gs2Grade:MultiplyAcquireActionsByUserId",
"Gs2Guild:IncreaseMaximumCurrentMaximumMemberCountByGuildName",
"Gs2Guild:SetMaximumCurrentMaximumMemberCountByGuildName",
"Gs2Idle:IncreaseMaximumIdleMinutesByUserId",
"Gs2Idle:SetMaximumIdleMinutesByUserId",
"Gs2Idle:ReceiveByUserId",
"Gs2Inbox:SendMessageByUserId",
"Gs2Inventory:AddCapacityByUserId",
"Gs2Inventory:SetCapacityByUserId",
"Gs2Inventory:AcquireItemSetByUserId",
"Gs2Inventory:AcquireItemSetWithGradeByUserId",
"Gs2Inventory:AddReferenceOfByUserId",
"Gs2Inventory:DeleteReferenceOfByUserId",
"Gs2Inventory:AcquireSimpleItemsByUserId",
"Gs2Inventory:SetSimpleItemsByUserId",
"Gs2Inventory:AcquireBigItemByUserId",
"Gs2Inventory:SetBigItemByUserId",
"Gs2JobQueue:PushByUserId",
"Gs2Limit:CountDownByUserId",
"Gs2Limit:DeleteCounterByUserId",
"Gs2LoginReward:DeleteReceiveStatusByUserId",
"Gs2LoginReward:UnmarkReceivedByUserId",
"Gs2Lottery:DrawByUserId",
"Gs2Lottery:ResetBoxByUserId",
"Gs2Mission:RevertReceiveByUserId",
"Gs2Mission:IncreaseCounterByUserId",
"Gs2Mission:SetCounterByUserId",
"Gs2Money:DepositByUserId",
"Gs2Money:RevertRecordReceipt",
"Gs2Money2:DepositByUserId",
"Gs2Quest:CreateProgressByUserId",
"Gs2Schedule:TriggerByUserId",
"Gs2Script:InvokeScript",
"Gs2SerialKey:RevertUseByUserId",
"Gs2SerialKey:IssueOnce",
"Gs2Showcase:DecrementPurchaseCountByUserId",
"Gs2Showcase:ForceReDrawByUserId",
"Gs2SkillTree:MarkReleaseByUserId",
"Gs2Stamina:RecoverStaminaByUserId",
"Gs2Stamina:RaiseMaxValueByUserId",
"Gs2Stamina:SetMaxValueByUserId",
"Gs2Stamina:SetRecoverIntervalByUserId",
"Gs2Stamina:SetRecoverValueByUserId",
"Gs2StateMachine:StartStateMachineByUserId",
}
~ 128文字入手アクションで実行するアクションの種類
requeststring~ 1048576文字リクエストのJSON

VerifyActionResult

検証アクションの実行結果

有効化条件必須デフォルト値の制限説明
actionenum {
}
~ 128文字検証アクションで実行するアクションの種類
verifyRequeststring~ 1048576文字リクエストのJSON
statusCodeint~ 999ステータスコード
verifyResultstring~ 1048576文字結果内容

action に指定する列挙型の定義

定義説明

ConsumeActionResult

消費アクションの実行結果

有効化条件必須デフォルト値の制限説明
actionenum {
}
~ 128文字消費アクションで実行するアクションの種類
consumeRequeststring~ 1048576文字リクエストのJSON
statusCodeint~ 999ステータスコード
consumeResultstring~ 1048576文字結果内容

action に指定する列挙型の定義

定義説明

AcquireActionResult

入手アクションの実行結果

有効化条件必須デフォルト値の制限説明
actionenum {
}
~ 128文字入手アクションで実行するアクションの種類
acquireRequeststring~ 1048576文字リクエストのJSON
statusCodeint~ 999ステータスコード
acquireResultstring~ 1048576文字結果内容

action に指定する列挙型の定義

定義説明

TransactionResult

トランザクション実行結果

サーバーサイドでのトランザクションの自動実行機能を利用して実行されたトランザクションの実行結果

有効化条件必須デフォルト値の制限説明
transactionIdstring36 ~ 36文字トランザクションID
verifyResultsList<VerifyActionResult>~ 10 items検証アクションの実行結果リスト
consumeResultsList<ConsumeActionResult>~ 10 items消費アクションの実行結果リスト
acquireResultsList<AcquireActionResult>~ 100 items入手アクションの実行結果リスト