GS2-Enchant マスターデータリファレンス
マスターデータのフォーマットと インポートする各種モデルのリファレンス
{
"version": "2023-07-18",
"balanceParameterModels": [
{
"name": "[string]バランスパラメーターモデル名",
"metadata": "[string?]メタデータ",
"totalValue": "[long]合計値",
"initialValueStrategy": "[string]初期値の設定方針",
"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]排出重み"
}
]
}
]
}
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| version | ✓ | 2023-07-18 | マスターデータのフォーマットバージョン | |||
| balanceParameterModels | List<BalanceParameterModel> | ~ 10000 items | バランスパラメーターモデル | |||
| rarityParameterModels | List<RarityParameterModel> | ~ 10000 items | レアリティパラメーターモデル |
BalanceParameterModel
バランスパラメーターモデル
バランスパラメーターの抽選条件を定義します。
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| balanceParameterModelId | string | ✓ | ~ 1024文字 | バランスパラメーターモデルGRN | ||||||||
| name | string | ✓ | ~ 128文字 | バランスパラメーターモデル名 | ||||||||
| metadata | string | ~ 2048文字 | メタデータ | |||||||||
| totalValue | long | ✓ | 0 ~ 9223372036854775805 | 合計値 | ||||||||
| initialValueStrategy | 文字列列挙型 enum { “average”, “lottery” } | ✓ | “average” | ~ 128文字 | 初期値の設定方針
| |||||||
| parameters | List<BalanceParameterValueModel> | ✓ | 1 ~ 10 items | バランスパラメーター値モデルのリスト |
RarityParameterModel
レアリティパラメーターモデル
レアリティパラメーターの抽選条件を定義します。
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| rarityParameterModelId | string | ✓ | ~ 1024文字 | レアリティパラメーターモデルGRN | ||
| name | string | ✓ | ~ 128文字 | レアリティパラメーターモデル名 | ||
| metadata | string | ~ 2048文字 | メタデータ | |||
| maximumParameterCount | int | ✓ | 1 ~ 10 | 付与するパラメーターの最大数 | ||
| parameterCounts | List<RarityParameterCountModel> | ✓ | 1 ~ 10 items | レアリティパラメーターの付与数モデルのリスト | ||
| parameters | List<RarityParameterValueModel> | ✓ | 1 ~ 1000 items | レアリティパラメーター値モデルのリスト |
BalanceParameterValueModel
バランスパラメーター値モデル
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| name | string | ✓ | ~ 64文字 | 名前 | ||
| metadata | string | ~ 512文字 | メタデータ |
RarityParameterCountModel
レアリティパラメーターの付与数モデル
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| count | int | ✓ | 0 ~ 10 | 値 | ||
| weight | int | ✓ | 1 ~ 2147483646 | 排出重み |
RarityParameterValueModel
レアリティパラメーター値モデル
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| name | string | ✓ | ~ 64文字 | 名前 | ||
| metadata | string | ~ 512文字 | メタデータ | |||
| resourceName | string | ✓ | ~ 64文字 | ゲーム内で使用するパラメーターリソースの種類を表す名前(GS2の動作のためには使用しません) | ||
| resourceValue | long | ✓ | 0 ~ 9223372036854775805 | ゲーム内で使用するパラメーターリソースの値(GS2の動作のためには使用しません) | ||
| weight | int | ✓ | 1 ~ 2147483646 | 排出重み |
BalanceParameterValue
バランスパラメーター値モデル
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| name | string | ✓ | ~ 64文字 | 名前 | ||
| value | long | ✓ | 0 ~ 9223372036854775805 | 値 |
RarityParameterValue
レアリティパラメーター値モデル
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| name | string | ✓ | ~ 64文字 | 名前 | ||
| resourceName | string | ✓ | ~ 64文字 | リソースの名前 | ||
| resourceValue | long | ✓ | 0 ~ 9223372036854775805 | リソースの値 |
VerifyActionResult
検証アクションの実行結果
ConsumeActionResult
消費アクションの実行結果
AcquireActionResult
入手アクションの実行結果
TransactionResult
トランザクション実行結果
サーバーサイドでのトランザクションの自動実行機能を利用して実行されたトランザクションの実行結果
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
|---|---|---|---|---|---|---|
| transactionId | string | ✓ | 36 ~ 36文字 | トランザクションID | ||
| verifyResults | List<VerifyActionResult> | 0 ~ 10 items | 検証アクションの実行結果リスト | |||
| consumeResults | List<ConsumeActionResult> | [] | 0 ~ 10 items | 消費アクションの実行結果リスト | ||
| acquireResults | List<AcquireActionResult> | [] | 0 ~ 100 items | 入手アクションの実行結果リスト | ||
| hasError | bool | ✓ | false | トランザクション実行中にエラーが発生したかどうか |