GS2-Stamina Buff 레퍼런스

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

Models

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

Gs2Stamina:Stamina

스태미나

버프 적용 대상 필드

maxValue

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

마스터 데이터 작성 예

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

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

버프 적용 조건 모델

Gs2Stamina:StaminaModel

스태미나 모델

마스터 데이터 작성 예

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

recoverIntervalMinutes

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

마스터 데이터 작성 예

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

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

버프 적용 조건 모델

Gs2Stamina:StaminaModel

스태미나 모델

마스터 데이터 작성 예

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

recoverValue

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

마스터 데이터 작성 예

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

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

버프 적용 조건 모델

Gs2Stamina:StaminaModel

스태미나 모델

마스터 데이터 작성 예

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

Action

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

Gs2Stamina:ConsumeStamina

스타미나 소비

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

버프 적용 대상 필드

consumeValue

Stamina - 스태미나

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

마스터 데이터 작성 예

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

버프 적용 조건 모델

Gs2Stamina:StaminaModel

스태미나 모델

마스터 데이터 작성 예

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

Gs2Stamina:ConsumeStaminaByUserId

사용자 ID를 지정하여 스타미나 소비

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

버프 적용 대상 필드

consumeValue

Stamina - 스태미나

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

마스터 데이터 작성 예

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

버프 적용 조건 모델

Gs2Stamina:StaminaModel

스태미나 모델

마스터 데이터 작성 예

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

Gs2Stamina:RecoverStaminaByUserId

사용자 ID를 지정하여 스타미나 회복

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

버프 적용 대상 필드

recoverValue

Stamina - 스태미나

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

마스터 데이터 작성 예

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

버프 적용 조건 모델

Gs2Stamina:StaminaModel

스태미나 모델

마스터 데이터 작성 예

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