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

{
  "version": "2019-09-09",
  "moldModels": [
    {
      "name": "[string]フォームの保存領域モデル名",
      "metadata": "[string?]メタデータ",
      "initialMaxCapacity": "[int]フォームを保存できる初期キャパシティ",
      "maxCapacity": "[int]フォームを保存できる最大キャパシティ",
      "formModel": {
        "formModelId": "[string]フォームモデルGRN",
        "name": "[string]フォームモデル名",
        "metadata": "[string?]メタデータ",
        "slots": [
          {
            "name": "[string]スロットモデル名",
            "propertyRegex": "[string]プロパティとして設定可能な値の正規表現",
            "metadata": "[string?]メタデータ"
          }
        ]
      }
    }
  ],
  "propertyFormModels": [
    {
      "name": "[string]プロパティフォームモデル名",
      "metadata": "[string?]メタデータ",
      "slots": [
        {
          "name": "[string]スロットモデル名",
          "propertyRegex": "[string]プロパティとして設定可能な値の正規表現",
          "metadata": "[string?]メタデータ"
        }
      ]
    }
  ]
}
有効化条件必須デフォルト値の制限説明
version2019-09-09マスターデータのフォーマットバージョン
moldModelsList<MoldModel>~ 100 items編成の情報を保存する領域
propertyFormModelsList<PropertyFormModel>~ 100 itemsプロパティ編成モデル

FormModel

編成モデル

編成状況を表すエンティティです。
編成できる領域として スロット を定義できます。

武器・防具 であれば 「右手」「左手」「胴」「腕」のような部位をスロットとし、
パーティであれば「前衛」「中衛」「後衛」のようなポジションをスロットとして表現できます。

有効化条件必須デフォルト値の制限説明
formModelIdstring~ 1024文字フォームモデルGRN
namestring~ 128文字フォームモデル名
metadatastring~ 2048文字メタデータ
slotsList<SlotModel>1 ~ 10 itemsスロットモデルリスト

MoldModel

編成の情報を保存する領域

パーティ編成であれば「火属性パーティ」「水属性パーティ」のような形で保存することを想定しています。
保存できる領域の数は制限することができ、個別に拡張することもできます。

有効化条件必須デフォルト値の制限説明
moldModelIdstring~ 1024文字フォームの保存領域GRN
namestring~ 128文字フォームの保存領域モデル名
metadatastring~ 2048文字メタデータ
initialMaxCapacityint1 ~ 2147483646フォームを保存できる初期キャパシティ
maxCapacityint1 ~ 2147483646フォームを保存できる最大キャパシティ
formModelFormModel

PropertyFormModel

プロパティ編成モデル

編成状況を表すエンティティです。
Mold / Form との違いは、スロット数を定義して、各スロットに編成を記録するのが Mold / Form で、
所有している装備に対してスキルを設定するような、数を事前に決めるのが難しい編成を表現するのに利用するのがプロパティ編成です。

有効化条件必須デフォルト値の制限説明
propertyFormModelIdstring~ 1024文字プロパティフォームモデルGRN
namestring~ 128文字プロパティフォームモデル名
metadatastring~ 2048文字メタデータ
slotsList<SlotModel>1 ~ 10 itemsスロットモデルリスト

Slot

スロット

有効化条件必須デフォルト値の制限説明
namestring~ 128文字スロットモデル名
propertyIdstring~ 1024文字プロパティID
metadatastring~ 1024文字メタデータ

SlotModel

スロットモデル

有効化条件必須デフォルト値の制限説明
namestring~ 128文字スロットモデル名
propertyRegexstring“.*”~ 512文字プロパティとして設定可能な値の正規表現
metadatastring~ 512文字メタデータ

SlotWithSignature

署名付きスロット

有効化条件必須デフォルト値の制限説明
namestring~ 128文字スロットモデル名
propertyTypeenum {
    “gs2_inventory”,
    “gs2_simple_inventory”,
    “gs2_dictionary”
}
~ 128文字プロパティの種類
bodystring~ 1048576文字ペイロード
signaturestring~ 1024文字プロパティIDのリソースを所有していることを証明する署名
metadatastring~ 1024文字メタデータ

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

定義説明
gs2_inventoryGS2-Inventory::ItemSet
gs2_simple_inventoryGS2-Inventory::SimpleItem
gs2_dictionaryGS2-Dictionary::Entry

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入手アクションの実行結果リスト