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"
}
]
}
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
---|
version | ✓ | | 2019-05-14 | マスターデータのフォーマットバージョン | | |
questGroupModels | List<QuestGroupModel> | | | | | |
Contents
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
---|
metadata | string | | | | ~ 256文字 | メタデータ |
completeAcquireActions | List<AcquireAction> | | | [] | | クエストクリア時の報酬 |
weight | int | | ✓ | 1 | 1 ~ 2147483646 | 抽選する重み |
Reward
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
---|
action | enum [] | | ✓ | | ~ 128文字 | スタンプシートを使用して実行するアクションの種類 |
request | string | | ✓ | | ~ 5242880文字 | リクエストモデル |
itemId | string | | ✓ | | ~ 1024文字 | 入手するリソースGRN |
value | int | | ✓ | | ~ 2147483646 | 入手する数量 |
QuestGroupModel
クエストグループモデル
クエストグループは複数のクエストをグルーピングするためのエンティティで、クエストの進行はグループ内で同時に1つしか実行できません。
つまり、並列でクエストを進行できるようにする必要がある場合はグループを分ける必要があります。
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
---|
questGroupModelId | string | | ✓ | | ~ 1024文字 | クエストグループGRN |
name | string | | ✓ | | ~ 128文字 | クエストグループ名 |
metadata | string | | | | ~ 1024文字 | メタデータ |
quests | List<QuestModel> | | | | | グループに属するクエスト |
challengePeriodEventId | string | | | | ~ 1024文字 | クエストに挑戦可能な期間を設定した GS2-Schedule イベントGRN |
QuestModel
クエストモデル
クエストはインゲームの開始に必要な対価とクリアしたときに得られる報酬を保持するエンティティです。
クリアしたときに得られる報酬は複数のバリエーションを用意でき、クエスト開始時に抽選することができます。
例えば、クエストのクリアフラグ管理は同じコンテンツだが、レアモンスターの出現有無で2種類のコンテンツを用意することができます。
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
---|
questModelId | string | | ✓ | | ~ 1024文字 | クエストモデルGRN |
name | string | | ✓ | | ~ 128文字 | クエストモデル名 |
metadata | string | | | | ~ 1024文字 | メタデータ |
contents | List<Contents> | | ✓ | | | クエストの内容 |
challengePeriodEventId | string | | | | ~ 1024文字 | クエストに挑戦可能な期間を設定した GS2-Schedule イベントGRN |
firstCompleteAcquireActions | List<AcquireAction> | | | [] | | 初回クリア報酬アクションリスト |
consumeActions | List<ConsumeAction> | | | [] | | クエストの参加料 |
failedAcquireActions | List<AcquireAction> | | | [] | | クエスト失敗時の報酬 |
premiseQuestNames | List<string> | | | [] | | クエストに挑戦するためにクリアしておく必要のあるクエスト名 |
AcquireAction
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
---|
action | enum [] | | ✓ | | ~ 128文字 | スタンプシートを使用して実行するアクションの種類 |
request | string | | ✓ | | ~ 1048576文字 | リクエストのJSON |
ConsumeAction
| 型 | 有効化条件 | 必須 | デフォルト | 値の制限 | 説明 |
---|
action | enum [] | | ✓ | | ~ 128文字 | スタンプタスクで実行するアクションの種類 |
request | string | | ✓ | | ~ 1048576文字 | 入手リクエストのJSON |