GS2-Enhance マスターデータリファレンス
{
"version": "2020-08-22",
"rateModels": [
{
"name": "[string]強化レート名",
"description": "[string?]説明文",
"metadata": "[string?]メタデータ",
"targetInventoryModelId": "[string]強化対象に使用できるインベントリ",
"acquireExperienceSuffix": "[string]GS2-Experience で入手した経験値を格納する プロパティID に付与するサフィックス",
"materialInventoryModelId": "[string]強化の素材となるアイテムセット(有効期限ごとのアイテム所持数量)のGRN",
"acquireExperienceHierarchy": [
"[string]ItemModelのメタデータに格納する、入手経験値を定義するJSONデータの階層構造の定義"
],
"experienceModelId": "[string]経験値モデルGRN",
"bonusRates": [
{
"rate": "[float]経験値ボーナスの倍率(1.0=ボーナスなし)",
"weight": "[int]抽選重み"
}
]
}
],
"unleashRateModels": [
{
"name": "[string]強化レート名",
"description": "[string?]説明文",
"metadata": "[string?]メタデータ",
"targetInventoryModelId": "[string]限界突破対象に使用できるインベントリ",
"gradeModelId": "[string]グレードモデル",
"gradeEntries": [
{
"gradeValue": "[long]対象グレード",
"needCount": "[int]同種のアイテムを何個消費するか"
}
]
}
]
}
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
version | ✓ | 2020-08-22 | マスターデータのフォーマットバージョン | |||
rateModels | List<RateModel> | ~ 10000 items | 強化レートモデル | |||
unleashRateModels | List<UnleashRateModel> | ~ 10000 items | 限界突破レート |
RateModel
強化レートモデル
強化レートは強化に使用する素材と強化対象を定義したデータです。
素材データ、強化対象データは共に GS2-Inventory で管理されている必要があります。
強化で得られる経験値は GS2-Inventory のメタデータにJSON形式で記録します。
ここではメタデータのどの階層に経験値の値が格納されているかを記載する必要があります。
強化時に一定の確率で 大成功
といった形で入手できる経験値量に補正値をかけることができます。
その抽選確率もこのエンティティで定義します。
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
rateModelId | string | ✓ | ~ 1024文字 | 強化レートモデルGRN | ||
name | string | ✓ | ~ 128文字 | 強化レート名 | ||
description | string | ~ 1024文字 | 説明文 | |||
metadata | string | ~ 2048文字 | メタデータ | |||
targetInventoryModelId | string | ✓ | ~ 1024文字 | 強化対象に使用できるインベントリ | ||
acquireExperienceSuffix | string | ✓ | ~ 1024文字 | GS2-Experience で入手した経験値を格納する プロパティID に付与するサフィックス | ||
materialInventoryModelId | string | ✓ | ~ 1024文字 | 強化の素材となるアイテムセット(有効期限ごとのアイテム所持数量)のGRN | ||
acquireExperienceHierarchy | List<string> | ~ 10 items | ItemModelのメタデータに格納する、入手経験値を定義するJSONデータの階層構造の定義 | |||
experienceModelId | string | ✓ | ~ 1024文字 | 経験値モデルGRN | ||
bonusRates | List<BonusRate> | ~ 1000 items | 経験値獲得量ボーナス |
UnleashRateModel
限界突破レート
限界突破レートは限界突破の対象と GS2-Grade 限界突破モデルを定義したデータです。
限界突破の対象データは GS2-Inventory で管理されている必要があります。
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
unleashRateModelId | string | ✓ | ~ 1024文字 | 限界突破レートモデルGRN | ||
name | string | ✓ | ~ 128文字 | 強化レート名 | ||
description | string | ~ 1024文字 | 説明文 | |||
metadata | string | ~ 2048文字 | メタデータ | |||
targetInventoryModelId | string | ✓ | ~ 1024文字 | 限界突破対象に使用できるインベントリ | ||
gradeModelId | string | ✓ | ~ 1024文字 | グレードモデル | ||
gradeEntries | List<UnleashRateEntryModel> | ✓ | 1 ~ 1000 items | グレードエントリリスト |
BonusRate
経験値獲得量ボーナス
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
rate | float | ✓ | 1.0 | ~ 10000 | 経験値ボーナスの倍率(1.0=ボーナスなし) | |
weight | int | ✓ | 1 | ~ 2147483645 | 抽選重み |
Material
強化素材
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
materialItemSetId | string | ✓ | ~ 1024文字 | 強化の素材となるアイテムセット(有効期限ごとのアイテム所持数量)のGRN | ||
count | int | ✓ | 1 | ~ 2147483645 | 消費数量 |
UnleashRateEntryModel
限界突破レートエントリモデル
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
gradeValue | long | ✓ | 1 ~ 1000 | 対象グレード | ||
needCount | int | ✓ | 1 ~ 1000 | 同種のアイテムを何個消費するか |
VerifyActionResult
検証アクションの実行結果
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
action | enum { } | ✓ | ~ 128文字 | 検証アクションで実行するアクションの種類 | ||
verifyRequest | string | ✓ | ~ 1048576文字 | リクエストのJSON | ||
statusCode | int | ~ 999 | ステータスコード | |||
verifyResult | string | ~ 1048576文字 | 結果内容 |
action に指定する列挙型の定義
定義 | 説明 |
---|
ConsumeActionResult
消費アクションの実行結果
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
action | enum { } | ✓ | ~ 128文字 | 消費アクションで実行するアクションの種類 | ||
consumeRequest | string | ✓ | ~ 1048576文字 | リクエストのJSON | ||
statusCode | int | ~ 999 | ステータスコード | |||
consumeResult | string | ~ 1048576文字 | 結果内容 |
action に指定する列挙型の定義
定義 | 説明 |
---|
AcquireActionResult
入手アクションの実行結果
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
action | enum { } | ✓ | ~ 128文字 | 入手アクションで実行するアクションの種類 | ||
acquireRequest | string | ✓ | ~ 1048576文字 | リクエストのJSON | ||
statusCode | int | ~ 999 | ステータスコード | |||
acquireResult | string | ~ 1048576文字 | 結果内容 |
action に指定する列挙型の定義
定義 | 説明 |
---|
TransactionResult
トランザクション実行結果
サーバーサイドでのトランザクションの自動実行機能を利用して実行されたトランザクションの実行結果
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
transactionId | string | ✓ | 36 ~ 36文字 | トランザクションID | ||
verifyResults | List<VerifyActionResult> | ~ 10 items | 検証アクションの実行結果リスト | |||
consumeResults | List<ConsumeActionResult> | ~ 10 items | 消費アクションの実行結果リスト | |||
acquireResults | List<AcquireActionResult> | ~ 100 items | 入手アクションの実行結果リスト |