Documentation index for AI agents

GS2-Limit Buff 레퍼런스

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

Action

버프 적용 가능한 액션의 종류

Gs2Limit:CountUp

카운트업

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

버프 적용 대상 필드

maxValue

Counter - 사용 횟수 제한의 현재 값

타입활성화 조건필수기본값값 제한설명
maxValueint1 ~ 2147483646카운트업을 허용하는 최댓값
마스터 데이터 작성 예
"targetAction": {
    "targetActionName": "Gs2Limit:CountUp",
    "targetFieldName": "maxValue",
    "conditionGrns": [
    ],
    "rate": 1.0
}

버프 적용 조건 모델

Gs2Limit:LimitModel

횟수 제한 모델

마스터 데이터 작성 예
"conditionGrns": [
    {
        "targetModelName": "Gs2Limit:LimitModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:limit:{namespaceName}:limit:{limitName}"
    }
]
Gs2Limit:Counter

사용 횟수 제한의 현재 값

마스터 데이터 작성 예
"conditionGrns": [
    {
        "targetModelName": "Gs2Limit:Counter",
        "targetGrn": "grn:gs2:{region}:{ownerId}:limit:{namespaceName}:user:{userId}:limit:{limitName}:counter:{counterName}"
    }
]

Gs2Limit:CountUpByUserId

사용자 ID를 지정하여 카운트업

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

버프 적용 대상 필드

maxValue

Counter - 사용 횟수 제한의 현재 값

타입활성화 조건필수기본값값 제한설명
maxValueint1 ~ 2147483646카운트업을 허용하는 최댓값
마스터 데이터 작성 예
"targetAction": {
    "targetActionName": "Gs2Limit:CountUpByUserId",
    "targetFieldName": "maxValue",
    "conditionGrns": [
    ],
    "rate": 1.0
}

버프 적용 조건 모델

Gs2Limit:LimitModel

횟수 제한 모델

마스터 데이터 작성 예
"conditionGrns": [
    {
        "targetModelName": "Gs2Limit:LimitModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:limit:{namespaceName}:limit:{limitName}"
    }
]
Gs2Limit:Counter

사용 횟수 제한의 현재 값

마스터 데이터 작성 예
"conditionGrns": [
    {
        "targetModelName": "Gs2Limit:Counter",
        "targetGrn": "grn:gs2:{region}:{ownerId}:limit:{namespaceName}:user:{userId}:limit:{limitName}:counter:{counterName}"
    }
]