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 | 0 ~ 9223372036854775805 | 経験値の初期値 | |
| defaultRankCap | long | ✓ | 0 ~ 9223372036854775805 | ランクキャップの初期値 | ||
| maxRankCap | long | ✓ | 0 ~ 9223372036854775805 | ランクキャップの最大値 | ||
| rankThreshold | Threshold | ✓ | ランクアップ閾値 | |||
| acquireActionRates | List<AcquireActionRate> | 0 ~ 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 | ランクごとの加算量(倍率) | 
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 | トランザクション実行中にエラーが発生したかどうか | 
AcquireAction
入手アクション