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.

Note

See BuffEntryModel for more information on the buff entry model.

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

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

Example Master Data

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

Buff Application Condition Model

Gs2Limit:LimitModel

Usage Limit Model

Example Master Data

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

Gs2Limit:Counter

Current Counter Value

Example Master Data

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

Gs2Limit:CountUpByUserId

Count-up by specifying a 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

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

Example Master Data

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

Buff Application Condition Model

Gs2Limit:LimitModel

Usage Limit Model

Example Master Data

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

Gs2Limit:Counter

Current Counter Value

Example Master Data

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