GS2-Experience Buff 레퍼런스

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

Models

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

Gs2Experience:Status

스테이터스

버프 적용 대상 필드

rankCapValue

	타입	활성화 조건	필수	기본값	값 제한	설명
rankCapValue	long		✓		0 ~ 9223372036854775805	현재 랭크 캡 이 스테이터스가 현재 도달할 수 있는 최대 랭크입니다. 초기값은 경험치 모델의 defaultRankCap으로 설정되며, 한계돌파 등의 랭크 캡 증가 조작을 통해 maxRankCap까지 끌어올릴 수 있습니다.

마스터 데이터 작성 예

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

"targetModel": {
    "targetModelName": "Gs2Experience:Status",
    "targetFieldName": "rankCapValue",
    "conditionGrns": [
    ],
    "rate": 1.0
}

버프 적용 조건 모델

Gs2Experience:ExperienceModel

경험치 모델

마스터 데이터 작성 예

"conditionGrns": [
    {
        "targetModelName": "Gs2Experience:ExperienceModel",
        "targetGrn": "grn:gs2:any:any:experience:{namespaceName}:model:{experienceName}"
    }
]

Gs2Experience:Status

스테이터스

마스터 데이터 작성 예

"conditionGrns": [
    {
        "targetModelName": "Gs2Experience:Status",
        "targetGrn": "grn:gs2:any:any:experience:{namespaceName}:user:any:experienceModel:{experienceName}:property:{propertyId}"
    }
]

Action

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

Gs2Experience:AddExperienceByUserId

사용자 ID를 지정하여 경험치를 가산

지정된 사용자의 상태에 경험치를 가산합니다. 랭크는 랭크업 임계값에 기반하여 자동으로 재계산됩니다.
truncateExperienceWhenRankUp이 true인 경우, 랭크업 시 임계값을 초과한 잉여 경험치는 절사됩니다. false(기본값)인 경우에는 다음 랭크로 이월됩니다.

버프 적용 대상 필드

experienceValue

Status - 스테이터스

	타입	활성화 조건	필수	기본값	값 제한	설명
experienceValue	long			0	0 ~ 9223372036854775805	획득 경험치

마스터 데이터 작성 예

"targetAction": {
    "targetActionName": "Gs2Experience:AddExperienceByUserId",
    "targetFieldName": "experienceValue",
    "conditionGrns": [
    ],
    "rate": 1.0
}

버프 적용 조건 모델

Gs2Experience:ExperienceModel

경험치 모델

마스터 데이터 작성 예

"conditionGrns": [
    {
        "targetModelName": "Gs2Experience:ExperienceModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:experience:{namespaceName}:model:{experienceName}"
    }
]

Gs2Experience:Status

스테이터스

마스터 데이터 작성 예

"conditionGrns": [
    {
        "targetModelName": "Gs2Experience:Status",
        "targetGrn": "grn:gs2:{region}:{ownerId}:experience:{namespaceName}:user:{userId}:experienceModel:{experienceName}:property:{propertyId}"
    }
]

Gs2Experience:SubExperience

경험치를 감산

요청한 사용자의 상태에서 경험치를 감산합니다. 경험치는 0 미만으로 내려가지 않습니다.
랭크는 랭크업 임계값에 기반하여 자동으로 재계산됩니다.

버프 적용 대상 필드

experienceValue

Status - 스테이터스

	타입	활성화 조건	필수	기본값	값 제한	설명
experienceValue	long			0	0 ~ 9223372036854775805	잃는 경험치

마스터 데이터 작성 예

"targetAction": {
    "targetActionName": "Gs2Experience:SubExperience",
    "targetFieldName": "experienceValue",
    "conditionGrns": [
    ],
    "rate": 1.0
}

버프 적용 조건 모델

Gs2Experience:ExperienceModel

경험치 모델

마스터 데이터 작성 예

"conditionGrns": [
    {
        "targetModelName": "Gs2Experience:ExperienceModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:experience:{namespaceName}:model:{experienceName}"
    }
]

Gs2Experience:Status

스테이터스

마스터 데이터 작성 예

"conditionGrns": [
    {
        "targetModelName": "Gs2Experience:Status",
        "targetGrn": "grn:gs2:{region}:{ownerId}:experience:{namespaceName}:user:{userId}:experienceModel:{experienceName}:property:{propertyId}"
    }
]

Gs2Experience:SubExperienceByUserId

사용자 ID를 지정하여 경험치를 감산

지정된 사용자의 상태에서 경험치를 감산합니다. 경험치는 0 미만으로 내려가지 않습니다.
랭크는 랭크업 임계값에 기반하여 자동으로 재계산됩니다.

버프 적용 대상 필드

experienceValue

Status - 스테이터스

	타입	활성화 조건	필수	기본값	값 제한	설명
experienceValue	long			0	0 ~ 9223372036854775805	잃는 경험치

마스터 데이터 작성 예

"targetAction": {
    "targetActionName": "Gs2Experience:SubExperienceByUserId",
    "targetFieldName": "experienceValue",
    "conditionGrns": [
    ],
    "rate": 1.0
}

버프 적용 조건 모델

Gs2Experience:ExperienceModel

경험치 모델

마스터 데이터 작성 예

"conditionGrns": [
    {
        "targetModelName": "Gs2Experience:ExperienceModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:experience:{namespaceName}:model:{experienceName}"
    }
]

Gs2Experience:Status

스테이터스

마스터 데이터 작성 예

"conditionGrns": [
    {
        "targetModelName": "Gs2Experience:Status",
        "targetGrn": "grn:gs2:{region}:{ownerId}:experience:{namespaceName}:user:{userId}:experienceModel:{experienceName}:property:{propertyId}"
    }
]