GS2-Experience マスターデータリファレンス
{
"version": "2019-01-11",
"experienceModels": [
{
"name": "[string]経験値モデル名",
"metadata": "[string?]メタデータ",
"defaultExperience": "[long]経験値の初期値",
"defaultRankCap": "[long]ランクキャップの初期値",
"maxRankCap": "[long]ランクキャップの最大値",
"rankThreshold": {
"metadata": "[string?]メタデータ",
"values": [
"[long]ランクアップ経験値閾値"
]
},
"acquireActionRates": [
{
"name": "[string]報酬加算テーブル名",
"mode": "[string]報酬加算テーブルの種類",
"rates": [
"[double]加算量(倍率)"
],
"bigRates": [
"[string]加算量(倍率)"
]
}
]
}
]
}
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
version | ✓ | 2019-01-11 | マスターデータのフォーマットバージョン | |||
experienceModels | List<ExperienceModel> | ~ 100 items | 経験値モデル |
ExperienceModel
経験値モデル
経験値モデルとは、ランクアップに必要な経験値の閾値や、デフォルトのランクキャップ・最大ランクキャップ毎に設定するエンティティです。
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
experienceModelId | string | ✓ | ~ 1024文字 | 経験値モデルGRN | ||
name | string | ✓ | ~ 128文字 | 経験値モデル名 | ||
metadata | string | ~ 2048文字 | メタデータ | |||
defaultExperience | long | ✓ | 0 | ~ 9223372036854775805 | 経験値の初期値 | |
defaultRankCap | long | ✓ | ~ 9223372036854775805 | ランクキャップの初期値 | ||
maxRankCap | long | ✓ | ~ 9223372036854775805 | ランクキャップの最大値 | ||
rankThreshold | Threshold | ✓ | ランクアップ閾値 | |||
acquireActionRates | List<AcquireActionRate> | ~ 100 items | 報酬加算テーブルリスト |
Threshold
ランクアップ閾値
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
metadata | string | ~ 2048文字 | メタデータ | |||
values | List<long> | ✓ | 1 ~ 10000 items | ランクアップ経験値閾値リスト |
AcquireActionRate
報酬加算テーブルマスター
ランクに応じて報酬の量を調整することができます。
型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 | |
---|---|---|---|---|---|---|
name | string | ✓ | ~ 128文字 | 報酬加算テーブル名 | ||
mode | enum { “double”, “big” } | ✓ | “double” | ~ 128文字 | 報酬加算テーブルの種類 | |
rates | List<double> | {mode} == “double” | ✓ | 1 ~ 10000 items | ランクごとの加算量(倍率) | |
bigRates | List<string> | {mode} == “big” | ✓ | 1 ~ 10000 items | ランクごとの加算量(倍率) |
mode に指定する列挙型の定義
定義 | 説明 |
---|---|
double | 2^48 未満の浮動小数点数 |
big | 文字列表記で1024桁未満の浮動小数点数 |
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 | 入手アクションの実行結果リスト |
AcquireAction
入手アクション