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

# GS2-Experience Buff 레퍼런스

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




**ℹ️ Note**

버프 엔트리 모델에 대한 자세한 내용은 [BuffEntryModel](api_reference/buff/master_data/#buffentrymodel)을 참조해 주세요.

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

### Gs2Experience:Status
스테이터스


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

##### rankCapValue


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


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

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


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



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

##### Gs2Experience:ExperienceModel


경험치 모델


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


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


##### Gs2Experience:Status


스테이터스


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


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


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

### Gs2Experience:AddExperienceByUserId
사용자 ID를 지정하여 경험치를 가산<br>

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


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

##### experienceValue


[Status - 스테이터스](../sdk#status)



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


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



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

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

##### Gs2Experience:ExperienceModel


경험치 모델


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


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


##### Gs2Experience:Status


스테이터스


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


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



---

### Gs2Experience:SubExperience
경험치를 감산<br>

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


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

##### experienceValue


[Status - 스테이터스](../sdk#status)



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


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



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

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

##### Gs2Experience:ExperienceModel


경험치 모델


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


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


##### Gs2Experience:Status


스테이터스


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


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



---

### Gs2Experience:SubExperienceByUserId
사용자 ID를 지정하여 경험치를 감산<br>

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


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

##### experienceValue


[Status - 스테이터스](../sdk#status)



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


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



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

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

##### Gs2Experience:ExperienceModel


경험치 모델


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


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


##### Gs2Experience:Status


스테이터스


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


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



---