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

{
  "version": "2019-05-14",
  "questGroupModels": [
    {
      "name": "[string]クエストグループ名",
      "metadata": "[string?]メタデータ",
      "quests": [
        {
          "questModelId": "[string]クエストモデルGRN",
          "name": "[string]クエストモデル名",
          "metadata": "[string?]メタデータ",
          "contents": [
            {
              "metadata": "[string?]メタデータ",
              "completeAcquireActions": [
                {
                  "action": "[string]スタンプシートを使用して実行するアクションの種類",
                  "request": "[string]リクエストのJSON"
                }
              ],
              "weight": "[int]抽選する重み"
            }
          ],
          "challengePeriodEventId": "[string?]クエストに挑戦可能な期間を設定した GS2-Schedule イベントGRN",
          "firstCompleteAcquireActions": [
            {
              "action": "[string]スタンプシートを使用して実行するアクションの種類",
              "request": "[string]リクエストのJSON"
            }
          ],
          "consumeActions": [
            {
              "action": "[string]スタンプタスクで実行するアクションの種類",
              "request": "[string]入手リクエストのJSON"
            }
          ],
          "failedAcquireActions": [
            {
              "action": "[string]スタンプシートを使用して実行するアクションの種類",
              "request": "[string]リクエストのJSON"
            }
          ],
          "premiseQuestNames": [
            "[string]クエストモデル名"
          ]
        }
      ],
      "challengePeriodEventId": "[string?]クエストに挑戦可能な期間を設定した GS2-Schedule イベントGRN"
    }
  ]
}
有効化条件必須デフォルト値の制限説明
version2019-05-14マスターデータのフォーマットバージョン
questGroupModelsList<QuestGroupModel>

Contents

有効化条件必須デフォルト値の制限説明
metadatastring~ 256文字メタデータ
completeAcquireActionsList<AcquireAction>[]クエストクリア時の報酬
weightint11 ~ 2147483646抽選する重み

Reward

有効化条件必須デフォルト値の制限説明
actionenum []~ 128文字スタンプシートを使用して実行するアクションの種類
requeststring~ 5242880文字リクエストモデル
itemIdstring~ 1024文字入手するリソースGRN
valueint~ 2147483646入手する数量

QuestGroupModel

クエストグループモデル

クエストグループは複数のクエストをグルーピングするためのエンティティで、クエストの進行はグループ内で同時に1つしか実行できません。 つまり、並列でクエストを進行できるようにする必要がある場合はグループを分ける必要があります。

有効化条件必須デフォルト値の制限説明
questGroupModelIdstring~ 1024文字クエストグループGRN
namestring~ 128文字クエストグループ名
metadatastring~ 1024文字メタデータ
questsList<QuestModel>グループに属するクエスト
challengePeriodEventIdstring~ 1024文字クエストに挑戦可能な期間を設定した GS2-Schedule イベントGRN

QuestModel

クエストモデル

クエストはインゲームの開始に必要な対価とクリアしたときに得られる報酬を保持するエンティティです。

クリアしたときに得られる報酬は複数のバリエーションを用意でき、クエスト開始時に抽選することができます。 例えば、クエストのクリアフラグ管理は同じコンテンツだが、レアモンスターの出現有無で2種類のコンテンツを用意することができます。

有効化条件必須デフォルト値の制限説明
questModelIdstring~ 1024文字クエストモデルGRN
namestring~ 128文字クエストモデル名
metadatastring~ 1024文字メタデータ
contentsList<Contents>クエストの内容
challengePeriodEventIdstring~ 1024文字クエストに挑戦可能な期間を設定した GS2-Schedule イベントGRN
firstCompleteAcquireActionsList<AcquireAction>[]初回クリア報酬アクションリスト
consumeActionsList<ConsumeAction>[]クエストの参加料
failedAcquireActionsList<AcquireAction>[]クエスト失敗時の報酬
premiseQuestNamesList<string>[]クエストに挑戦するためにクリアしておく必要のあるクエスト名

AcquireAction

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

ConsumeAction

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