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

# GS2-Limit Buff 레퍼런스

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




**ℹ️ Note**

버프 엔트리 모델에 대한 자세한 내용은 [BuffEntryModel](api_reference/buff/master_data/#buffentrymodel)을 참조해 주세요.
## Action
버프 적용 가능한 액션의 종류

### Gs2Limit:CountUp
카운트업<br>

요청한 사용자의 카운터를 지정된 카운트업 값만큼 증가시킵니다.<br>
maxValue가 지정된 경우, 카운터는 해당 상한을 초과하지 않습니다. 작업이 최대값을 초과하는 경우 Overflow 오류가 반환됩니다.<br>
카운터가 아직 존재하지 않는 경우, 카운트 0으로 자동 생성된 후 증가합니다.


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

##### maxValue


[Counter - 사용 횟수 제한의 현재 값](../sdk#counter)



|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| maxValue | int |  | |  | 1 ~ 2147483646 | 카운트업을 허용하는 최댓값 |


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



**JSON**
```json
"targetAction": {
    "targetActionName": "Gs2Limit:CountUp",
    "targetFieldName": "maxValue",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```

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

##### Gs2Limit:LimitModel


횟수 제한 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Limit:LimitModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:limit:{namespaceName}:limit:{limitName}"
    }
]
```


##### Gs2Limit:Counter


사용 횟수 제한의 현재 값


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Limit:Counter",
        "targetGrn": "grn:gs2:{region}:{ownerId}:limit:{namespaceName}:user:{userId}:limit:{limitName}:counter:{counterName}"
    }
]
```



---

### Gs2Limit:CountUpByUserId
사용자 ID를 지정하여 카운트업<br>

지정된 사용자의 카운터를 지정된 카운트업 값만큼 증가시킵니다.<br>
maxValue가 지정된 경우, 카운터는 해당 상한을 초과하지 않습니다. 작업이 최대값을 초과하는 경우 Overflow 오류가 반환됩니다.<br>
카운터가 아직 존재하지 않는 경우, 자동으로 생성됩니다.


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

##### maxValue


[Counter - 사용 횟수 제한의 현재 값](../sdk#counter)



|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| maxValue | int |  | |  | 1 ~ 2147483646 | 카운트업을 허용하는 최댓값 |


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



**JSON**
```json
"targetAction": {
    "targetActionName": "Gs2Limit:CountUpByUserId",
    "targetFieldName": "maxValue",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```

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

##### Gs2Limit:LimitModel


횟수 제한 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Limit:LimitModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:limit:{namespaceName}:limit:{limitName}"
    }
]
```


##### Gs2Limit:Counter


사용 횟수 제한의 현재 값


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Limit:Counter",
        "targetGrn": "grn:gs2:{region}:{ownerId}:limit:{namespaceName}:user:{userId}:limit:{limitName}:counter:{counterName}"
    }
]
```



---



