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

# GS2-Stamina Buff 레퍼런스

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




**ℹ️ Note**

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

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

### Gs2Stamina:Stamina
스태미나


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

##### maxValue


|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| maxValue | int |  | ✓|  | 1 ~ 2147483646 | 스태미나 최대값<br>StaminaModel로부터 결정되며, 옵션으로 플레이어의 GS2-Experience 랭크에 따라 MaxStaminaTable로 오버라이드되는 사용자별 스태미나 최대값입니다.<br>오버플로우가 비활성화된 경우 initialCapacity가 하한이 됩니다. 오버플로우가 활성화된 경우 maxCapacity가 상한이 됩니다.<br>자연 회복은 이 값에서 멈춥니다. |


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

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


**JSON**
```json
"targetModel": {
    "targetModelName": "Gs2Stamina:Stamina",
    "targetFieldName": "maxValue",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```



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

##### Gs2Stamina:StaminaModel


스태미나 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Stamina:StaminaModel",
        "targetGrn": "grn:gs2:any:any:stamina:{namespaceName}:model:{staminaName}"
    }
]
```


---
##### recoverIntervalMinutes


|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| recoverIntervalMinutes | int |  | |  | 1 ~ 2147483646 | 스태미나 회복 간격(분)<br>StaminaModel로부터 결정되며, 옵션으로 플레이어의 GS2-Experience 랭크에 따라 RecoverIntervalTable로 오버라이드되는 사용자별 회복 간격(분)입니다.<br>테이블이 설정되어 있지 않은 경우, 모델의 기본값인 recoverIntervalMinutes로 대체됩니다. |


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

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


**JSON**
```json
"targetModel": {
    "targetModelName": "Gs2Stamina:Stamina",
    "targetFieldName": "recoverIntervalMinutes",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```



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

##### Gs2Stamina:StaminaModel


스태미나 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Stamina:StaminaModel",
        "targetGrn": "grn:gs2:any:any:stamina:{namespaceName}:model:{staminaName}"
    }
]
```


---
##### recoverValue


|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| recoverValue | int |  | |  | 1 ~ 2147483646 | 스태미나 회복량<br>StaminaModel로부터 결정되며, 옵션으로 플레이어의 GS2-Experience 랭크에 따라 RecoverValueTable로 오버라이드되는 사용자별 틱당 회복량입니다.<br>테이블이 설정되어 있지 않은 경우, 모델의 기본값인 recoverValue로 대체됩니다. |


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

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


**JSON**
```json
"targetModel": {
    "targetModelName": "Gs2Stamina:Stamina",
    "targetFieldName": "recoverValue",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```



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

##### Gs2Stamina:StaminaModel


스태미나 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Stamina:StaminaModel",
        "targetGrn": "grn:gs2:any:any:stamina:{namespaceName}:model:{staminaName}"
    }
]
```


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

### Gs2Stamina:ConsumeStamina
스타미나 소비<br>

현재 스타미나 값에서 지정된 양을 차감합니다. 현재 스타미나 값이 소비량보다 적은 경우 Insufficient 오류를 반환합니다.


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

##### consumeValue


[Stamina - 스태미나](../sdk#stamina)



|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| consumeValue | int |  | ✓|  | 1 ~ 2147483646 | 소비할 스타미나 양 |


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



**JSON**
```json
"targetAction": {
    "targetActionName": "Gs2Stamina:ConsumeStamina",
    "targetFieldName": "consumeValue",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```

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

##### Gs2Stamina:StaminaModel


스태미나 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Stamina:StaminaModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:stamina:{namespaceName}:model:{staminaName}"
    }
]
```



---

### Gs2Stamina:ConsumeStaminaByUserId
사용자 ID를 지정하여 스타미나 소비<br>

지정된 사용자의 현재 스타미나 값에서 지정된 양을 차감합니다. 현재 스타미나 값이 소비량보다 적은 경우 Insufficient 오류를 반환합니다.


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

##### consumeValue


[Stamina - 스태미나](../sdk#stamina)



|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| consumeValue | int |  | ✓|  | 1 ~ 2147483646 | 소비할 스타미나 양 |


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



**JSON**
```json
"targetAction": {
    "targetActionName": "Gs2Stamina:ConsumeStaminaByUserId",
    "targetFieldName": "consumeValue",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```

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

##### Gs2Stamina:StaminaModel


스태미나 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Stamina:StaminaModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:stamina:{namespaceName}:model:{staminaName}"
    }
]
```



---

### Gs2Stamina:RecoverStaminaByUserId
사용자 ID를 지정하여 스타미나 회복<br>

지정된 양의 스타미나를 최대 용량까지 회복합니다. 회복으로 인해 값이 최대값을 초과하고 오버플로 모드가 활성화된 경우, 초과분은 오버플로 값으로 기록됩니다.


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

##### recoverValue


[Stamina - 스태미나](../sdk#stamina)



|  | 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 |
| --- | --- | --- | --- | --- | --- | --- |
| recoverValue | int |  | ✓|  | 1 ~ 2147483646 | 스타미나의 회복량 |


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



**JSON**
```json
"targetAction": {
    "targetActionName": "Gs2Stamina:RecoverStaminaByUserId",
    "targetFieldName": "recoverValue",
    "conditionGrns": [
    ],
    "rate": 1.0
}
```

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

##### Gs2Stamina:StaminaModel


스태미나 모델


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


**JSON**
```json
"conditionGrns": [
    {
        "targetModelName": "Gs2Stamina:StaminaModel",
        "targetGrn": "grn:gs2:{region}:{ownerId}:stamina:{namespaceName}:model:{staminaName}"
    }
]
```



---