> For the complete documentation index, see [llms.txt](/llms.txt)

# GS2-Quest Buff 레퍼런스

GS2-Buff로 버프를 적용할 때 지정하는, 파라미터 보정이 가능한 모델/액션 내 필드와 그 적용 범위 설정에 대해




**ℹ️ Note**

버프 엔트리 모델에 대한 자세한 내용은 [BuffEntryModel](api_reference/buff/master_data/#buffentrymodel)을 참조해 주세요.

## Models
버프 적용 가능한 모델의 종류

### Gs2Quest:QuestModel
퀘스트 모델


#### 버프 적용 대상 필드

##### completeAcquireActions


|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| completeAcquireActions | List&lt;AcquireAction&gt; |  | | [] | 0 ~ 10 items | 클리어 보상 획득 액션<br>이 콘텐츠 배리에이션으로 퀘스트를 클리어했을 때 실행되는 획득 액션입니다. 플레이어가 퀘스트 클리어 시 받게 되는 실제 보상을 정의합니다. |


##### 마스터 데이터 작성 예

`rate`에는 대상 필드에 대한 보정 배율을 지정합니다.


**JSON**
```json
"targetModel": {
    "targetModelName": "Gs2Quest:QuestModel",
    "targetFieldName": "completeAcquireActions",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```



#### 버프 적용 조건 모델

##### Gs2Quest:QuestGroupModel


퀘스트 그룹 모델


##### 마스터 데이터 작성 예


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Quest:QuestGroupModel",
        "targetGrn": "grn:gs2:any:any:quest:{namespaceName}:group:{questGroupName}"
    }
]
```


##### Gs2Quest:QuestModel


퀘스트 모델


##### 마스터 데이터 작성 예


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Quest:QuestModel",
        "targetGrn": "grn:gs2:any:any:quest:{namespaceName}:group:{questGroupName}:quest:{questName}"
    }
]
```


---
##### firstCompleteAcquireActions


|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| firstCompleteAcquireActions | List&lt;AcquireAction&gt; |  | | [] | 0 ~ 10 items | 최초 클리어 보상 입수 액션 리스트<br>이 퀘스트를 처음 클리어했을 때만 실행되는 입수 액션의 리스트입니다. 일반 클리어 보상에 더해 지급되는 보너스 보상으로, 최초 클리어 보너스를 구현하는 데 사용합니다. |


##### 마스터 데이터 작성 예

`rate`에는 대상 필드에 대한 보정 배율을 지정합니다.


**JSON**
```json
"targetModel": {
    "targetModelName": "Gs2Quest:QuestModel",
    "targetFieldName": "firstCompleteAcquireActions",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```



#### 버프 적용 조건 모델

##### Gs2Quest:QuestGroupModel


퀘스트 그룹 모델


##### 마스터 데이터 작성 예


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Quest:QuestGroupModel",
        "targetGrn": "grn:gs2:any:any:quest:{namespaceName}:group:{questGroupName}"
    }
]
```


##### Gs2Quest:QuestModel


퀘스트 모델


##### 마스터 데이터 작성 예


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Quest:QuestModel",
        "targetGrn": "grn:gs2:any:any:quest:{namespaceName}:group:{questGroupName}:quest:{questName}"
    }
]
```


---
##### failedAcquireActions


|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| failedAcquireActions | List&lt;AcquireAction&gt; |  | | [] | 0 ~ 100 items | 실패 시 입수 액션 리스트<br>퀘스트 실패 시 실행되는 입수 액션입니다. 실패 시 위로 보상이나 퀘스트 참가 비용의 일부 반환 등에 사용합니다. |


##### 마스터 데이터 작성 예

`rate`에는 대상 필드에 대한 보정 배율을 지정합니다.


**JSON**
```json
"targetModel": {
    "targetModelName": "Gs2Quest:QuestModel",
    "targetFieldName": "failedAcquireActions",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```



#### 버프 적용 조건 모델

##### Gs2Quest:QuestGroupModel


퀘스트 그룹 모델


##### 마스터 데이터 작성 예


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Quest:QuestGroupModel",
        "targetGrn": "grn:gs2:any:any:quest:{namespaceName}:group:{questGroupName}"
    }
]
```


##### Gs2Quest:QuestModel


퀘스트 모델


##### 마스터 데이터 작성 예


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Quest:QuestModel",
        "targetGrn": "grn:gs2:any:any:quest:{namespaceName}:group:{questGroupName}:quest:{questName}"
    }
]
```


---
##### verifyActions


|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| verifyActions | List&lt;VerifyAction&gt; |  | | [] | 0 ~ 10 items | 검증 액션 리스트<br>이 퀘스트를 시작하기 위한 전제 조건이 되는 검증 액션의 리스트입니다. 모든 검증 액션이 성공해야만 퀘스트를 시작할 수 있습니다. 레벨 확인이나 아이템 소지 등의 요건을 강제하는 데 사용합니다. |


##### 마스터 데이터 작성 예

`rate`에는 대상 필드에 대한 보정 배율을 지정합니다.


**JSON**
```json
"targetModel": {
    "targetModelName": "Gs2Quest:QuestModel",
    "targetFieldName": "verifyActions",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```



#### 버프 적용 조건 모델

##### Gs2Quest:QuestGroupModel


퀘스트 그룹 모델


##### 마스터 데이터 작성 예


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Quest:QuestGroupModel",
        "targetGrn": "grn:gs2:any:any:quest:{namespaceName}:group:{questGroupName}"
    }
]
```


##### Gs2Quest:QuestModel


퀘스트 모델


##### 마스터 데이터 작성 예


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Quest:QuestModel",
        "targetGrn": "grn:gs2:any:any:quest:{namespaceName}:group:{questGroupName}:quest:{questName}"
    }
]
```


---
##### consumeActions


|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| consumeActions | List&lt;ConsumeAction&gt; |  | | [] | 0 ~ 10 items | 소비 액션 리스트<br>이 퀘스트의 시작 비용으로 실행되는 소비 액션입니다. 스태미나나 통화 등의 비용이 퀘스트 시작 시 소비됩니다. |


##### 마스터 데이터 작성 예

`rate`에는 대상 필드에 대한 보정 배율을 지정합니다.


**JSON**
```json
"targetModel": {
    "targetModelName": "Gs2Quest:QuestModel",
    "targetFieldName": "consumeActions",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```



#### 버프 적용 조건 모델

##### Gs2Quest:QuestGroupModel


퀘스트 그룹 모델


##### 마스터 데이터 작성 예


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Quest:QuestGroupModel",
        "targetGrn": "grn:gs2:any:any:quest:{namespaceName}:group:{questGroupName}"
    }
]
```


##### Gs2Quest:QuestModel


퀘스트 모델


##### 마스터 데이터 작성 예


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Quest:QuestModel",
        "targetGrn": "grn:gs2:any:any:quest:{namespaceName}:group:{questGroupName}:quest:{questName}"
    }
]
```


---