GS2-Stamina 트랜잭션 액션
Verify Action
검증 액션
Gs2Stamina:VerifyStaminaValueByUserId
사용자 ID를 지정하여 스타미나 현재값을 검증
지정된 사용자의 현재 스타미나 값이 지정된 조건을 지정된 임계값에 대해 충족하는지, 상태를 변경하지 않고 검증합니다.
수량 지정 가능한 액션: 예
| 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128자 | 네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. | ||||||||||||||||
| userId | string | ✓ | ~ 128자 | 사용자ID#{userId}로 설정하면 로그인 중인 사용자ID로 치환됩니다. | ||||||||||||||||
| staminaName | string | ✓ | ~ 128자 | 스태미나 모델 이름 이 스태미나 인스턴스의 회복 파라미터, 용량, 테이블 참조를 정의하는 StaminaModel의 이름입니다. 사용자별 스태미나 상태를 대응하는 모델 정의와 연결합니다. | ||||||||||||||||
| verifyType | 문자열 열거형 enum { “less”, “lessEqual”, “greater”, “greaterEqual”, “equal”, “notEqual” } | ✓ | 검증 종류
| |||||||||||||||||
| value | int | ✓ | 0 ~ 2147483646 | 현재값 | ||||||||||||||||
| multiplyValueSpecifyingQuantity | bool | true | 수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부 | |||||||||||||||||
| timeOffsetToken | string | ~ 1024자 | 타임 오프셋 토큰 |
{
"action": "Gs2Stamina:VerifyStaminaValueByUserId",
"request": {
"namespaceName": "[string]네임스페이스 이름",
"userId": "[string]사용자ID",
"staminaName": "[string]스태미나 모델 이름",
"verifyType": "[string]검증 종류",
"value": "[int]현재값",
"multiplyValueSpecifyingQuantity": "[bool]수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부",
"timeOffsetToken": "[string]타임 오프셋 토큰"
}
}action: Gs2Stamina:VerifyStaminaValueByUserId
request:
namespaceName: "[string]네임스페이스 이름"
userId: "[string]사용자ID"
staminaName: "[string]스태미나 모델 이름"
verifyType: "[string]검증 종류"
value: "[int]현재값"
multiplyValueSpecifyingQuantity: "[bool]수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부"
timeOffsetToken: "[string]타임 오프셋 토큰"transaction.service("stamina").verify.verify_stamina_value_by_user_id({
namespaceName="[string]네임스페이스 이름",
userId="[string]사용자ID",
staminaName="[string]스태미나 모델 이름",
verifyType="[string]검증 종류",
value="[int]현재값",
multiplyValueSpecifyingQuantity="[bool]수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부",
timeOffsetToken="[string]타임 오프셋 토큰",
})Gs2Stamina:VerifyStaminaMaxValueByUserId
사용자 ID를 지정하여 스태미나 최댓값 검증
지정된 사용자의 스태미나 최대 용량(버프에 의한 변경 포함)이 지정된 조건을 지정된 임곗값에 대해 충족하는지, 상태를 변경하지 않고 검증합니다.
수량 지정 가능한 액션: 예
| 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128자 | 네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. | ||||||||||||||||
| userId | string | ✓ | ~ 128자 | 사용자ID#{userId}로 설정하면 로그인 중인 사용자ID로 치환됩니다. | ||||||||||||||||
| staminaName | string | ✓ | ~ 128자 | 스태미나 모델 이름 이 스태미나 인스턴스의 회복 파라미터, 용량, 테이블 참조를 정의하는 StaminaModel의 이름입니다. 사용자별 스태미나 상태를 대응하는 모델 정의와 연결합니다. | ||||||||||||||||
| verifyType | 문자열 열거형 enum { “less”, “lessEqual”, “greater”, “greaterEqual”, “equal”, “notEqual” } | ✓ | 검증 종류
| |||||||||||||||||
| value | int | ✓ | 0 ~ 2147483646 | 최대값 | ||||||||||||||||
| multiplyValueSpecifyingQuantity | bool | true | 수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부 | |||||||||||||||||
| timeOffsetToken | string | ~ 1024자 | 타임 오프셋 토큰 |
{
"action": "Gs2Stamina:VerifyStaminaMaxValueByUserId",
"request": {
"namespaceName": "[string]네임스페이스 이름",
"userId": "[string]사용자ID",
"staminaName": "[string]스태미나 모델 이름",
"verifyType": "[string]검증 종류",
"value": "[int]최대값",
"multiplyValueSpecifyingQuantity": "[bool]수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부",
"timeOffsetToken": "[string]타임 오프셋 토큰"
}
}action: Gs2Stamina:VerifyStaminaMaxValueByUserId
request:
namespaceName: "[string]네임스페이스 이름"
userId: "[string]사용자ID"
staminaName: "[string]스태미나 모델 이름"
verifyType: "[string]검증 종류"
value: "[int]최대값"
multiplyValueSpecifyingQuantity: "[bool]수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부"
timeOffsetToken: "[string]타임 오프셋 토큰"transaction.service("stamina").verify.verify_stamina_max_value_by_user_id({
namespaceName="[string]네임스페이스 이름",
userId="[string]사용자ID",
staminaName="[string]스태미나 모델 이름",
verifyType="[string]검증 종류",
value="[int]최대값",
multiplyValueSpecifyingQuantity="[bool]수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부",
timeOffsetToken="[string]타임 오프셋 토큰",
})Gs2Stamina:VerifyStaminaRecoverIntervalMinutesByUserId
사용자 ID를 지정하여 스태미나 회복 간격(분) 검증
지정된 사용자의 스태미나 회복 간격(분)이 지정된 조건을 지정된 임곗값에 대해 충족하는지, 상태를 변경하지 않고 검증합니다.
수량 지정 가능한 액션: 예
| 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128자 | 네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. | ||||||||||||||||
| userId | string | ✓ | ~ 128자 | 사용자ID#{userId}로 설정하면 로그인 중인 사용자ID로 치환됩니다. | ||||||||||||||||
| staminaName | string | ✓ | ~ 128자 | 스태미나 모델 이름 이 스태미나 인스턴스의 회복 파라미터, 용량, 테이블 참조를 정의하는 StaminaModel의 이름입니다. 사용자별 스태미나 상태를 대응하는 모델 정의와 연결합니다. | ||||||||||||||||
| verifyType | 문자열 열거형 enum { “less”, “lessEqual”, “greater”, “greaterEqual”, “equal”, “notEqual” } | ✓ | 검증 종류
| |||||||||||||||||
| value | int | ✓ | 0 ~ 2147483646 | 회복 속도 | ||||||||||||||||
| multiplyValueSpecifyingQuantity | bool | true | 수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부 | |||||||||||||||||
| timeOffsetToken | string | ~ 1024자 | 타임 오프셋 토큰 |
{
"action": "Gs2Stamina:VerifyStaminaRecoverIntervalMinutesByUserId",
"request": {
"namespaceName": "[string]네임스페이스 이름",
"userId": "[string]사용자ID",
"staminaName": "[string]스태미나 모델 이름",
"verifyType": "[string]검증 종류",
"value": "[int]회복 속도",
"multiplyValueSpecifyingQuantity": "[bool]수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부",
"timeOffsetToken": "[string]타임 오프셋 토큰"
}
}action: Gs2Stamina:VerifyStaminaRecoverIntervalMinutesByUserId
request:
namespaceName: "[string]네임스페이스 이름"
userId: "[string]사용자ID"
staminaName: "[string]스태미나 모델 이름"
verifyType: "[string]검증 종류"
value: "[int]회복 속도"
multiplyValueSpecifyingQuantity: "[bool]수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부"
timeOffsetToken: "[string]타임 오프셋 토큰"transaction.service("stamina").verify.verify_stamina_recover_interval_minutes_by_user_id({
namespaceName="[string]네임스페이스 이름",
userId="[string]사용자ID",
staminaName="[string]스태미나 모델 이름",
verifyType="[string]검증 종류",
value="[int]회복 속도",
multiplyValueSpecifyingQuantity="[bool]수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부",
timeOffsetToken="[string]타임 오프셋 토큰",
})Gs2Stamina:VerifyStaminaRecoverValueByUserId
사용자 ID를 지정하여 스태미나 회복량 검증
지정된 사용자의 스태미나 회복량(버프에 의한 변경 포함)이 지정된 조건을 지정된 임곗값에 대해 충족하는지, 상태를 변경하지 않고 검증합니다.
수량 지정 가능한 액션: 예
| 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128자 | 네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. | ||||||||||||||||
| userId | string | ✓ | ~ 128자 | 사용자ID#{userId}로 설정하면 로그인 중인 사용자ID로 치환됩니다. | ||||||||||||||||
| staminaName | string | ✓ | ~ 128자 | 스태미나 모델 이름 이 스태미나 인스턴스의 회복 파라미터, 용량, 테이블 참조를 정의하는 StaminaModel의 이름입니다. 사용자별 스태미나 상태를 대응하는 모델 정의와 연결합니다. | ||||||||||||||||
| verifyType | 문자열 열거형 enum { “less”, “lessEqual”, “greater”, “greaterEqual”, “equal”, “notEqual” } | ✓ | 검증 종류
| |||||||||||||||||
| value | int | ✓ | 0 ~ 2147483646 | 회복량 | ||||||||||||||||
| multiplyValueSpecifyingQuantity | bool | true | 수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부 | |||||||||||||||||
| timeOffsetToken | string | ~ 1024자 | 타임 오프셋 토큰 |
{
"action": "Gs2Stamina:VerifyStaminaRecoverValueByUserId",
"request": {
"namespaceName": "[string]네임스페이스 이름",
"userId": "[string]사용자ID",
"staminaName": "[string]스태미나 모델 이름",
"verifyType": "[string]검증 종류",
"value": "[int]회복량",
"multiplyValueSpecifyingQuantity": "[bool]수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부",
"timeOffsetToken": "[string]타임 오프셋 토큰"
}
}action: Gs2Stamina:VerifyStaminaRecoverValueByUserId
request:
namespaceName: "[string]네임스페이스 이름"
userId: "[string]사용자ID"
staminaName: "[string]스태미나 모델 이름"
verifyType: "[string]검증 종류"
value: "[int]회복량"
multiplyValueSpecifyingQuantity: "[bool]수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부"
timeOffsetToken: "[string]타임 오프셋 토큰"transaction.service("stamina").verify.verify_stamina_recover_value_by_user_id({
namespaceName="[string]네임스페이스 이름",
userId="[string]사용자ID",
staminaName="[string]스태미나 모델 이름",
verifyType="[string]검증 종류",
value="[int]회복량",
multiplyValueSpecifyingQuantity="[bool]수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부",
timeOffsetToken="[string]타임 오프셋 토큰",
})Gs2Stamina:VerifyStaminaOverflowValueByUserId
사용자 ID를 지정하여 스태미나 오버플로우량 검증
지정된 사용자의 스태미나 오버플로우량이 지정된 조건을 지정된 임곗값에 대해 충족하는지, 상태를 변경하지 않고 검증합니다.
수량 지정 가능한 액션: 예
| 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 | |||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128자 | 네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. | ||||||||||||||||
| userId | string | ✓ | ~ 128자 | 사용자ID#{userId}로 설정하면 로그인 중인 사용자ID로 치환됩니다. | ||||||||||||||||
| staminaName | string | ✓ | ~ 128자 | 스태미나 모델 이름 이 스태미나 인스턴스의 회복 파라미터, 용량, 테이블 참조를 정의하는 StaminaModel의 이름입니다. 사용자별 스태미나 상태를 대응하는 모델 정의와 연결합니다. | ||||||||||||||||
| verifyType | 문자열 열거형 enum { “less”, “lessEqual”, “greater”, “greaterEqual”, “equal”, “notEqual” } | ✓ | 검증 종류
| |||||||||||||||||
| value | int | ✓ | 0 ~ 2147483646 | 오버플로우량 | ||||||||||||||||
| multiplyValueSpecifyingQuantity | bool | true | 수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부 | |||||||||||||||||
| timeOffsetToken | string | ~ 1024자 | 타임 오프셋 토큰 |
{
"action": "Gs2Stamina:VerifyStaminaOverflowValueByUserId",
"request": {
"namespaceName": "[string]네임스페이스 이름",
"userId": "[string]사용자ID",
"staminaName": "[string]스태미나 모델 이름",
"verifyType": "[string]검증 종류",
"value": "[int]오버플로우량",
"multiplyValueSpecifyingQuantity": "[bool]수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부",
"timeOffsetToken": "[string]타임 오프셋 토큰"
}
}action: Gs2Stamina:VerifyStaminaOverflowValueByUserId
request:
namespaceName: "[string]네임스페이스 이름"
userId: "[string]사용자ID"
staminaName: "[string]스태미나 모델 이름"
verifyType: "[string]검증 종류"
value: "[int]오버플로우량"
multiplyValueSpecifyingQuantity: "[bool]수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부"
timeOffsetToken: "[string]타임 오프셋 토큰"transaction.service("stamina").verify.verify_stamina_overflow_value_by_user_id({
namespaceName="[string]네임스페이스 이름",
userId="[string]사용자ID",
staminaName="[string]스태미나 모델 이름",
verifyType="[string]검증 종류",
value="[int]오버플로우량",
multiplyValueSpecifyingQuantity="[bool]수량을 지정했을 때, 검증에 사용하는 값도 곱할지 여부",
timeOffsetToken="[string]타임 오프셋 토큰",
})Consume Action
소비 액션
Gs2Stamina:DecreaseMaxValueByUserId
사용자 ID를 지정하여 스타미나 최대값 감산
지정된 사용자의 스타미나 최대 용량을 지정된 양만큼 감소시킵니다. 스타미나 용량에 대한 디버프나 페널티 적용에 사용할 수 있습니다.
수량 지정 가능한 액션: 예
반전 가능한 액션: 예
| 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 | |
|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128자 | 네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. | ||
| staminaName | string | ✓ | ~ 128자 | 스태미나 모델 이름 이 스태미나 인스턴스의 회복 파라미터, 용량, 테이블 참조를 정의하는 StaminaModel의 이름입니다. 사용자별 스태미나 상태를 대응하는 모델 정의와 연결합니다. | ||
| userId | string | ✓ | ~ 128자 | 사용자ID#{userId}로 설정하면 로그인 중인 사용자ID로 치환됩니다. | ||
| decreaseValue | int | ✓ | 0 ~ 2147483646 | 감산할 최대 스타미나 양 | ||
| timeOffsetToken | string | ~ 1024자 | 타임 오프셋 토큰 |
{
"action": "Gs2Stamina:DecreaseMaxValueByUserId",
"request": {
"namespaceName": "[string]네임스페이스 이름",
"staminaName": "[string]스태미나 모델 이름",
"userId": "[string]사용자ID",
"decreaseValue": "[int]감산할 최대 스타미나 양",
"timeOffsetToken": "[string]타임 오프셋 토큰"
}
}action: Gs2Stamina:DecreaseMaxValueByUserId
request:
namespaceName: "[string]네임스페이스 이름"
staminaName: "[string]스태미나 모델 이름"
userId: "[string]사용자ID"
decreaseValue: "[int]감산할 최대 스타미나 양"
timeOffsetToken: "[string]타임 오프셋 토큰"transaction.service("stamina").consume.decrease_max_value_by_user_id({
namespaceName="[string]네임스페이스 이름",
staminaName="[string]스태미나 모델 이름",
userId="[string]사용자ID",
decreaseValue="[int]감산할 최대 스타미나 양",
timeOffsetToken="[string]타임 오프셋 토큰",
})Gs2Stamina:ConsumeStaminaByUserId
사용자 ID를 지정하여 스타미나 소비
지정된 사용자의 현재 스타미나 값에서 지정된 양을 차감합니다. 현재 스타미나 값이 소비량보다 적은 경우 Insufficient 오류를 반환합니다.
수량 지정 가능한 액션: 예
반전 가능한 액션: 예
| 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 | |
|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128자 | 네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. | ||
| staminaName | string | ✓ | ~ 128자 | 스태미나 모델 이름 이 스태미나 인스턴스의 회복 파라미터, 용량, 테이블 참조를 정의하는 StaminaModel의 이름입니다. 사용자별 스태미나 상태를 대응하는 모델 정의와 연결합니다. | ||
| userId | string | ✓ | ~ 128자 | 사용자ID#{userId}로 설정하면 로그인 중인 사용자ID로 치환됩니다. | ||
| consumeValue | int | ✓ | 1 ~ 2147483646 | 소비할 스타미나 양 | ||
| timeOffsetToken | string | ~ 1024자 | 타임 오프셋 토큰 |
{
"action": "Gs2Stamina:ConsumeStaminaByUserId",
"request": {
"namespaceName": "[string]네임스페이스 이름",
"staminaName": "[string]스태미나 모델 이름",
"userId": "[string]사용자ID",
"consumeValue": "[int]소비할 스타미나 양",
"timeOffsetToken": "[string]타임 오프셋 토큰"
}
}action: Gs2Stamina:ConsumeStaminaByUserId
request:
namespaceName: "[string]네임스페이스 이름"
staminaName: "[string]스태미나 모델 이름"
userId: "[string]사용자ID"
consumeValue: "[int]소비할 스타미나 양"
timeOffsetToken: "[string]타임 오프셋 토큰"transaction.service("stamina").consume.consume_stamina_by_user_id({
namespaceName="[string]네임스페이스 이름",
staminaName="[string]스태미나 모델 이름",
userId="[string]사용자ID",
consumeValue="[int]소비할 스타미나 양",
timeOffsetToken="[string]타임 오프셋 토큰",
})Acquire Action
입수 액션
Gs2Stamina:RecoverStaminaByUserId
사용자 ID를 지정하여 스타미나 회복
지정된 양의 스타미나를 최대 용량까지 회복합니다. 회복으로 인해 값이 최대값을 초과하고 오버플로 모드가 활성화된 경우, 초과분은 오버플로 값으로 기록됩니다.
수량 지정 가능한 액션: 예
반전 가능한 액션: 예
| 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 | |
|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128자 | 네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. | ||
| staminaName | string | ✓ | ~ 128자 | 스태미나 모델 이름 이 스태미나 인스턴스의 회복 파라미터, 용량, 테이블 참조를 정의하는 StaminaModel의 이름입니다. 사용자별 스태미나 상태를 대응하는 모델 정의와 연결합니다. | ||
| userId | string | ✓ | ~ 128자 | 사용자ID#{userId}로 설정하면 로그인 중인 사용자ID로 치환됩니다. | ||
| recoverValue | int | ✓ | 1 ~ 2147483646 | 스타미나의 회복량 | ||
| timeOffsetToken | string | ~ 1024자 | 타임 오프셋 토큰 |
{
"action": "Gs2Stamina:RecoverStaminaByUserId",
"request": {
"namespaceName": "[string]네임스페이스 이름",
"staminaName": "[string]스태미나 모델 이름",
"userId": "[string]사용자ID",
"recoverValue": "[int]스타미나의 회복량",
"timeOffsetToken": "[string]타임 오프셋 토큰"
}
}action: Gs2Stamina:RecoverStaminaByUserId
request:
namespaceName: "[string]네임스페이스 이름"
staminaName: "[string]스태미나 모델 이름"
userId: "[string]사용자ID"
recoverValue: "[int]스타미나의 회복량"
timeOffsetToken: "[string]타임 오프셋 토큰"transaction.service("stamina").acquire.recover_stamina_by_user_id({
namespaceName="[string]네임스페이스 이름",
staminaName="[string]스태미나 모델 이름",
userId="[string]사용자ID",
recoverValue="[int]스타미나의 회복량",
timeOffsetToken="[string]타임 오프셋 토큰",
})Gs2Stamina:RaiseMaxValueByUserId
사용자 ID를 지정하여 스타미나의 최대값을 가산
지정된 양만큼 스타미나의 최대 용량을 영구적으로 증가시킵니다. 레벨업 보상이나 아이템 효과 등 영구적인 스탯 상승에 사용됩니다.
수량 지정 가능한 액션: 예
반전 가능한 액션: 예
| 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 | |
|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128자 | 네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. | ||
| staminaName | string | ✓ | ~ 128자 | 스태미나 모델 이름 이 스태미나 인스턴스의 회복 파라미터, 용량, 테이블 참조를 정의하는 StaminaModel의 이름입니다. 사용자별 스태미나 상태를 대응하는 모델 정의와 연결합니다. | ||
| userId | string | ✓ | ~ 128자 | 사용자ID#{userId}로 설정하면 로그인 중인 사용자ID로 치환됩니다. | ||
| raiseValue | int | ✓ | 0 ~ 2147483646 | 증가시킬 최대 스타미나 양 | ||
| timeOffsetToken | string | ~ 1024자 | 타임 오프셋 토큰 |
{
"action": "Gs2Stamina:RaiseMaxValueByUserId",
"request": {
"namespaceName": "[string]네임스페이스 이름",
"staminaName": "[string]스태미나 모델 이름",
"userId": "[string]사용자ID",
"raiseValue": "[int]증가시킬 최대 스타미나 양",
"timeOffsetToken": "[string]타임 오프셋 토큰"
}
}action: Gs2Stamina:RaiseMaxValueByUserId
request:
namespaceName: "[string]네임스페이스 이름"
staminaName: "[string]스태미나 모델 이름"
userId: "[string]사용자ID"
raiseValue: "[int]증가시킬 최대 스타미나 양"
timeOffsetToken: "[string]타임 오프셋 토큰"transaction.service("stamina").acquire.raise_max_value_by_user_id({
namespaceName="[string]네임스페이스 이름",
staminaName="[string]스태미나 모델 이름",
userId="[string]사용자ID",
raiseValue="[int]증가시킬 최대 스타미나 양",
timeOffsetToken="[string]타임 오프셋 토큰",
})Gs2Stamina:SetMaxValueByUserId
사용자 ID를 지정하여 스타미나의 최대값을 갱신
스타미나의 최대 용량을 지정된 값으로 설정합니다. 감사 목적으로 변경 전 스타미나 상태가 응답에 유지됩니다. 관리자에 의한 오버라이드나 특별 이벤트에서의 조정에 사용됩니다.
수량 지정 가능한 액션: 예
반전 가능한 액션: 아니오
| 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 | |
|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128자 | 네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. | ||
| staminaName | string | ✓ | ~ 128자 | 스태미나 모델 이름 이 스태미나 인스턴스의 회복 파라미터, 용량, 테이블 참조를 정의하는 StaminaModel의 이름입니다. 사용자별 스태미나 상태를 대응하는 모델 정의와 연결합니다. | ||
| userId | string | ✓ | ~ 128자 | 사용자ID#{userId}로 설정하면 로그인 중인 사용자ID로 치환됩니다. | ||
| maxValue | int | ✓ | 1 ~ 2147483646 | 스태미나 최대값 StaminaModel로부터 결정되며, 옵션으로 플레이어의 GS2-Experience 랭크에 따라 MaxStaminaTable로 오버라이드되는 사용자별 스태미나 최대값입니다. 오버플로우가 비활성화된 경우 initialCapacity가 하한이 됩니다. 오버플로우가 활성화된 경우 maxCapacity가 상한이 됩니다. 자연 회복은 이 값에서 멈춥니다. | ||
| timeOffsetToken | string | ~ 1024자 | 타임 오프셋 토큰 |
{
"action": "Gs2Stamina:SetMaxValueByUserId",
"request": {
"namespaceName": "[string]네임스페이스 이름",
"staminaName": "[string]스태미나 모델 이름",
"userId": "[string]사용자ID",
"maxValue": "[int]스태미나 최대값",
"timeOffsetToken": "[string]타임 오프셋 토큰"
}
}action: Gs2Stamina:SetMaxValueByUserId
request:
namespaceName: "[string]네임스페이스 이름"
staminaName: "[string]스태미나 모델 이름"
userId: "[string]사용자ID"
maxValue: "[int]스태미나 최대값"
timeOffsetToken: "[string]타임 오프셋 토큰"transaction.service("stamina").acquire.set_max_value_by_user_id({
namespaceName="[string]네임스페이스 이름",
staminaName="[string]스태미나 모델 이름",
userId="[string]사용자ID",
maxValue="[int]스태미나 최대값",
timeOffsetToken="[string]타임 오프셋 토큰",
})Gs2Stamina:SetRecoverIntervalByUserId
사용자 ID를 지정하여 스타미나 회복 간격(분)을 갱신
스타미나 회복 간격을 지정된 값(분)으로 설정합니다. 감사 목적으로 변경 전 스타미나 상태가 응답에 유지됩니다. 스타미나가 자동으로 회복되는 빈도를 제어합니다.
수량 지정 가능한 액션: 예
반전 가능한 액션: 아니오
| 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 | |
|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128자 | 네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. | ||
| staminaName | string | ✓ | ~ 128자 | 스태미나 모델 이름 이 스태미나 인스턴스의 회복 파라미터, 용량, 테이블 참조를 정의하는 StaminaModel의 이름입니다. 사용자별 스태미나 상태를 대응하는 모델 정의와 연결합니다. | ||
| userId | string | ✓ | ~ 128자 | 사용자ID#{userId}로 설정하면 로그인 중인 사용자ID로 치환됩니다. | ||
| recoverIntervalMinutes | int | ✓ | 1 ~ 2147483646 | 스타미나 회복 간격(분) | ||
| timeOffsetToken | string | ~ 1024자 | 타임 오프셋 토큰 |
{
"action": "Gs2Stamina:SetRecoverIntervalByUserId",
"request": {
"namespaceName": "[string]네임스페이스 이름",
"staminaName": "[string]스태미나 모델 이름",
"userId": "[string]사용자ID",
"recoverIntervalMinutes": "[int]스타미나 회복 간격(분)",
"timeOffsetToken": "[string]타임 오프셋 토큰"
}
}action: Gs2Stamina:SetRecoverIntervalByUserId
request:
namespaceName: "[string]네임스페이스 이름"
staminaName: "[string]스태미나 모델 이름"
userId: "[string]사용자ID"
recoverIntervalMinutes: "[int]스타미나 회복 간격(분)"
timeOffsetToken: "[string]타임 오프셋 토큰"transaction.service("stamina").acquire.set_recover_interval_by_user_id({
namespaceName="[string]네임스페이스 이름",
staminaName="[string]스태미나 모델 이름",
userId="[string]사용자ID",
recoverIntervalMinutes="[int]스타미나 회복 간격(분)",
timeOffsetToken="[string]타임 오프셋 토큰",
})Gs2Stamina:SetRecoverValueByUserId
사용자 ID를 지정하여 스타미나의 회복량을 설정
스타미나의 회복량을 지정된 값으로 설정합니다. 감사 목적으로 변경 전 스타미나 상태가 응답에 유지됩니다. 회복 간격마다 회복되는 스타미나 양을 제어합니다.
수량 지정 가능한 액션: 예
반전 가능한 액션: 아니오
| 타입 | 활성화 조건 | 필수 | 기본값 | 값 제한 | 설명 | |
|---|---|---|---|---|---|---|
| namespaceName | string | ✓ | ~ 128자 | 네임스페이스 이름 네임스페이스 고유의 이름입니다. 영숫자 및 -(하이픈) _(언더스코어) .(마침표)로 지정합니다. | ||
| staminaName | string | ✓ | ~ 128자 | 스태미나 모델 이름 이 스태미나 인스턴스의 회복 파라미터, 용량, 테이블 참조를 정의하는 StaminaModel의 이름입니다. 사용자별 스태미나 상태를 대응하는 모델 정의와 연결합니다. | ||
| userId | string | ✓ | ~ 128자 | 사용자ID#{userId}로 설정하면 로그인 중인 사용자ID로 치환됩니다. | ||
| recoverValue | int | ✓ | 1 ~ 2147483646 | 스타미나의 회복량 | ||
| timeOffsetToken | string | ~ 1024자 | 타임 오프셋 토큰 |
{
"action": "Gs2Stamina:SetRecoverValueByUserId",
"request": {
"namespaceName": "[string]네임스페이스 이름",
"staminaName": "[string]스태미나 모델 이름",
"userId": "[string]사용자ID",
"recoverValue": "[int]스타미나의 회복량",
"timeOffsetToken": "[string]타임 오프셋 토큰"
}
}action: Gs2Stamina:SetRecoverValueByUserId
request:
namespaceName: "[string]네임스페이스 이름"
staminaName: "[string]스태미나 모델 이름"
userId: "[string]사용자ID"
recoverValue: "[int]스타미나의 회복량"
timeOffsetToken: "[string]타임 오프셋 토큰"transaction.service("stamina").acquire.set_recover_value_by_user_id({
namespaceName="[string]네임스페이스 이름",
staminaName="[string]스태미나 모델 이름",
userId="[string]사용자ID",
recoverValue="[int]스타미나의 회복량",
timeOffsetToken="[string]타임 오프셋 토큰",
})