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

# GS2-Showcase Buff 레퍼런스

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




**ℹ️ Note**

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

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

### Gs2Showcase:DisplayItem
진열 상품


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

##### acquireActions


|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| acquireActions | List&lt;AcquireAction&gt; |  | | [] | 1 ~ 100 items | 획득 액션 리스트<br>구매 보상으로 리소스를 부여하는 액션입니다. 모든 소비 액션이 정상적으로 완료된 후에 실행됩니다. |


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

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


**JSON**
```json
"targetModel": {
    "targetModelName": "Gs2Showcase:DisplayItem",
    "targetFieldName": "acquireActions",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```



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

##### Gs2Showcase:Showcase


진열대


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:Showcase",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:showcase:{showcaseName}"
    }
]
```


##### Gs2Showcase:DisplayItem


진열 상품


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:DisplayItem",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:showcase:{showcaseName}:displayItem:{displayItemId}"
    }
]
```


---
##### verifyActions


|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| verifyActions | List&lt;VerifyAction&gt; |  | | [] | 0 ~ 10 items | 검증 액션 리스트<br>구매 전에 실행되는 전제 조건 체크입니다. 모든 검증 액션이 성공한 후에 소비·획득 액션이 처리됩니다. 구매 자격 조건 체크에 사용할 수 있습니다. |


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

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


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



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

##### Gs2Showcase:Showcase


진열대


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:Showcase",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:showcase:{showcaseName}"
    }
]
```


##### Gs2Showcase:DisplayItem


진열 상품


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:DisplayItem",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:showcase:{showcaseName}:displayItem:{displayItemId}"
    }
]
```


---
##### consumeActions


|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| consumeActions | List&lt;ConsumeAction&gt; |  | | [] | 0 ~ 10 items | 소비 액션 리스트<br>구매 대가로 리소스를 소비하는 액션입니다. 상품 그룹의 구매 횟수 제어를 위해 GS2-Limit의 CountUp 액션을 포함할 수 있습니다. |


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

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


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



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

##### Gs2Showcase:Showcase


진열대


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:Showcase",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:showcase:{showcaseName}"
    }
]
```


##### Gs2Showcase:DisplayItem


진열 상품


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:DisplayItem",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:showcase:{showcaseName}:displayItem:{displayItemId}"
    }
]
```


---

### Gs2Showcase:RandomDisplayItemModel
랜덤 진열대에 진열 가능한 상품


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

##### acquireActions


|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| acquireActions | List&lt;AcquireAction&gt; |  | | [] | 1 ~ 100 items | 획득 액션 목록<br>이 랜덤 진열 상품의 구매 보상으로 리소스를 지급하는 액션입니다. 트랜잭션의 획득 액션으로 실행됩니다. |


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

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


**JSON**
```json
"targetModel": {
    "targetModelName": "Gs2Showcase:RandomDisplayItemModel",
    "targetFieldName": "acquireActions",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```



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

##### Gs2Showcase:RandomShowcase


랜덤 진열대


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:RandomShowcase",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:random:showcase:{showcaseName}"
    }
]
```


##### Gs2Showcase:RandomDisplayItemModel


랜덤 진열대에 진열 가능한 상품


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:RandomDisplayItemModel",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:randomDisplayItem:{displayItemId}"
    }
]
```


---
##### verifyActions


|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| verifyActions | List&lt;VerifyAction&gt; |  | | [] | 0 ~ 10 items | 검증 액션 목록<br>이 랜덤 진열 상품을 구매하기 전에 실행되는 전제 조건 확인입니다. 모든 검증 액션이 성공한 후에 소비·획득 액션이 처리됩니다. |


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

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


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



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

##### Gs2Showcase:RandomShowcase


랜덤 진열대


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:RandomShowcase",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:random:showcase:{showcaseName}"
    }
]
```


##### Gs2Showcase:RandomDisplayItemModel


랜덤 진열대에 진열 가능한 상품


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:RandomDisplayItemModel",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:randomDisplayItem:{displayItemId}"
    }
]
```


---
##### consumeActions


|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| consumeActions | List&lt;ConsumeAction&gt; |  | | [] | 0 ~ 10 items | 소비 액션 목록<br>이 랜덤 진열 상품의 구매 대가로 리소스를 소비하는 액션입니다. 트랜잭션의 소비 액션으로 실행됩니다. |


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

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


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



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

##### Gs2Showcase:RandomShowcase


랜덤 진열대


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:RandomShowcase",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:random:showcase:{showcaseName}"
    }
]
```


##### Gs2Showcase:RandomDisplayItemModel


랜덤 진열대에 진열 가능한 상품


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:RandomDisplayItemModel",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:randomDisplayItem:{displayItemId}"
    }
]
```


---
##### stock


|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| stock | int |  | ✓|  | 1 ~ 2147483646 | 재고 수<br>모든 로테이션을 통틀어 이 상품이 추첨될 수 있는 최대 횟수입니다. 재고가 0이 되면 이후 추첨에서 제외됩니다. 로테이션 추첨 시 상품이 선택되면 재고가 소비됩니다. |


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

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


**JSON**
```json
"targetModel": {
    "targetModelName": "Gs2Showcase:RandomDisplayItemModel",
    "targetFieldName": "stock",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```



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

##### Gs2Showcase:RandomShowcase


랜덤 진열대


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:RandomShowcase",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:random:showcase:{showcaseName}"
    }
]
```


##### Gs2Showcase:RandomDisplayItemModel


랜덤 진열대에 진열 가능한 상품


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Showcase:RandomDisplayItemModel",
        "targetGrn": "grn:gs2:any:any:showcase:{namespaceName}:randomDisplayItem:{displayItemId}"
    }
]
```


---