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

# GS2-Limit Buff Reference

Describes the fields within models/actions whose parameters can be adjusted when applying buffs with GS2-Buff, and how to configure the scope in which those buffs are applied.




{{% alert title="Note" color="info" %}}
See [BuffEntryModel](api_reference/buff/master_data/#buffentrymodel) for more information on the buff entry model.
{{% /alert %}}
## Action
Types of actions that can apply buffs

### Gs2Limit:CountUp
Count-up

Increments the requesting user's counter by the specified count-up value.
If maxValue is specified, the counter will not exceed that limit; an Overflow error is returned if the operation would exceed the maximum.
If the counter does not yet exist, it is automatically created with a count of 0 before incrementing.


#### Target fields for buff application

##### maxValue


[Counter - Current Counter Value](../sdk#counter)



|  | Type | Condition | Required | Default | Value Limits | Description |
| --- | --- | --- | --- | --- | --- | --- |
| maxValue | int |  | |  | 1 ~ 2147483646 | Maximum value allowed to count up |


##### Example Master Data



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

#### Buff Application Condition Model

##### Gs2Limit:LimitModel


Usage Limit Model


##### Example Master Data


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


##### Gs2Limit:Counter


Current Counter Value


##### Example Master Data


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



---

### Gs2Limit:CountUpByUserId
Count-up by User ID

Increments the specified user's counter by the specified count-up value.
If maxValue is specified, the counter will not exceed that limit; an Overflow error is returned if the operation would exceed the maximum.
If the counter does not yet exist, it is automatically created.


#### Target fields for buff application

##### maxValue


[Counter - Current Counter Value](../sdk#counter)



|  | Type | Condition | Required | Default | Value Limits | Description |
| --- | --- | --- | --- | --- | --- | --- |
| maxValue | int |  | |  | 1 ~ 2147483646 | Maximum value allowed to count up |


##### Example Master Data



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

#### Buff Application Condition Model

##### Gs2Limit:LimitModel


Usage Limit Model


##### Example Master Data


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


##### Gs2Limit:Counter


Current Counter Value


##### Example Master Data


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



---