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

{
  "version": "2019-08-19",
  "rateModels": [
    {
      "name": "[string]交換レートの名前",
      "metadata": "[string?]メタデータ",
      "consumeActions": [
        {
          "action": "[string]スタンプタスクで実行するアクションの種類",
          "request": "[string]入手リクエストのJSON"
        }
      ],
      "timingType": "[string]交換の種類",
      "lockTime": "[int]交換実行から実際に報酬を受け取れるようになるまでの待ち時間(分)",
      "enableSkip": "[bool]スキップをすることができるか",
      "skipConsumeActions": [
        {
          "action": "[string]スタンプタスクで実行するアクションの種類",
          "request": "[string]入手リクエストのJSON"
        }
      ],
      "acquireActions": [
        {
          "action": "[string]スタンプシートを使用して実行するアクションの種類",
          "request": "[string]リクエストのJSON"
        }
      ]
    }
  ],
  "incrementalRateModels": [
    {
      "name": "[string]コスト上昇型交換レートの名前",
      "metadata": "[string?]メタデータ",
      "consumeAction": {
        "action": "[string]スタンプタスクで実行するアクションの種類",
        "request": "[string]入手リクエストのJSON"
      },
      "calculateType": "[string]コスト上昇量の計算方式",
      "baseValue": "[long]ベース値",
      "coefficientValue": "[long]係数",
      "calculateScriptId": "[string]コスト計算スクリプトのGRN",
      "exchangeCountId": "[string]交換実行回数を管理する GS2-Limit の回数制限モデルGRN",
      "maximumExchangeCount": "[int]交換回数の上限",
      "acquireActions": [
        {
          "action": "[string]スタンプシートを使用して実行するアクションの種類",
          "request": "[string]リクエストのJSON"
        }
      ]
    }
  ]
}
有効化条件必須デフォルト値の制限説明
version2019-08-19マスターデータのフォーマットバージョン
rateModelsList<RateModel>
incrementalRateModelsList<IncrementalRateModel>

RateModel

交換レートモデル

交換レートはリソースとリソースを交換する際に使用するレートを定義するエンティティです。

直ちに交換できるレートだけでなく、現実時間で一定時間経過したのちに交換できるレートを設定できます。 現実時間での時間経過が必要な交換レートには、更に即時交換を実行するために必要なリソースを定義することが可能です。

有効化条件必須デフォルト値の制限説明
rateModelIdstring~ 1024文字交換レートモデルGRN
namestring~ 128文字交換レートの名前
metadatastring~ 2048文字メタデータ
consumeActionsList<ConsumeAction>[]消費アクションリスト
timingTypeenum [‘immediate’, ‘await’]“immediate”~ 128文字交換の種類
lockTimeint{timingType} == “await”~ 525600交換実行から実際に報酬を受け取れるようになるまでの待ち時間(分)
enableSkipbool{timingType} == “await”falseスキップをすることができるか
skipConsumeActionsList<ConsumeAction>{skipConsumeActions}[]時短消費アクションリスト
acquireActionsList<AcquireAction>[]入手アクションリスト

IncrementalRateModel

コスト上昇型交換レートモデル

通常の交換レートは常に一定のレートでの交換を提供します。 上昇型交換レートでは、交換回数に応じてコストが上昇していくレートを定義することができます。 例えば、1回目の交換では 1:1 で交換できるが、2回目の交換では 2:1 で交換できる、といったレートを定義することができます。 このようなレートを定義することで、プレイヤーがゲームを進めることで得られるリソースの価値を上げることができます。

交換回数は現実時間の経過でリセットすることができます。 この機能を利用することで、毎日あるいは毎週交換に必要なコストをリセットすることができます。

有効化条件必須デフォルト値の制限説明
incrementalRateModelIdstring~ 1024文字コスト上昇型交換レートモデルGRN
namestring~ 128文字コスト上昇型交換レートの名前
metadatastring~ 2048文字メタデータ
consumeActionConsumeAction消費アクション(数量/値は上書きされるため設定不要です)
calculateTypeenum [’linear’, ‘power’, ‘gs2_script’]~ 128文字コスト上昇量の計算方式
baseValuelong{calculateType} == “linear”~ 9223372036854775805ベース値
coefficientValuelong{calculateType} in [“linear”, “power”]~ 9223372036854775805係数
calculateScriptIdstring{calculateType} == “gs2_script”~ 1024文字コスト計算スクリプトのGRN
exchangeCountIdstring~ 1024文字交換実行回数を管理する GS2-Limit の回数制限モデルGRN
maximumExchangeCountint2147483646~ 2147483646交換回数の上限
acquireActionsList<AcquireAction>[]入手アクションリスト

AcquireAction

有効化条件必須デフォルト値の制限説明
actionenum []~ 128文字スタンプシートを使用して実行するアクションの種類
requeststring~ 1048576文字リクエストのJSON

ConsumeAction

有効化条件必須デフォルト値の制限説明
actionenum []~ 128文字スタンプタスクで実行するアクションの種類
requeststring~ 1048576文字入手リクエストのJSON