Buff on Game Server Services | Docs

GS2-Buff

Mon, 01 Jan 0001 00:00:00 +0000

GS2-Buff는 GS2가 제공하는 마이크로서비스의 대가와 보상, 사용자 데이터 최대값의 보정을 일원화하여 관리하는 기능을 제공합니다. 기간 한정으로 보상을 증가시키는 기능이나, 구독 계약 상태라면 사용자 데이터의 최대값이 증가하는 기능을 구현할 때 활용할 수 있습니다.

GS2-Buff는 다른 마이크로서비스를 직접 수정하는 것이 아니라, API 호출 시 전달되는 “컨텍스트 스택"이라는 메타 정보를 통해 각 마이크로서비스에 보정값을 전파합니다. 따라서 버프의 내용이나 기간을 변경하더라도 각 마이크로서비스의 마스터 데이터나 플레이어 데이터를 전혀 수정하지 않고도 적용·해제가 가능하다는 점이 큰 특징입니다.

GS2-Exchange Buff 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

Note

버프 엔트리 모델에 대한 자세한 내용은 BuffEntryModel을 참조해 주세요.

Models

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

Gs2Exchange:RateModel

교환 레이트 모델

버프 적용 대상 필드

lockTime

	타입	활성화 조건	필수	기본값	값 제한	설명
lockTime	int	{timingType} == “await”	✓※		0 ~ 538214400	교환 실행부터 실제로 보상을 받을 수 있게 될 때까지의 대기 시간(분) timingType이 `await`인 경우에만 적용됩니다. 교환이 시작된 후 플레이어가 보상을 받을 수 있게 되기까지 경과해야 하는 실시간 분수를 지정합니다. 대기 시간은 스킵 기능을 사용하여 단축할 수 있습니다. ※ timingType이(가) “await” 이면 필수

마스터 데이터 작성 예

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

GS2-Experience Buff 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

Note

버프 엔트리 모델에 대한 자세한 내용은 BuffEntryModel을 참조해 주세요.

Models

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

Gs2Experience:Status

스테이터스

버프 적용 대상 필드

rankCapValue

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

마스터 데이터 작성 예

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

GS2-Formation Buff 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

Note

버프 엔트리 모델에 대한 자세한 내용은 BuffEntryModel을 참조해 주세요.

Models

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

Gs2Formation:Mold

폼 저장 영역

버프 적용 대상 필드

capacity

	타입	활성화 조건	필수	기본값	값 제한	설명
capacity	int		✓		0 ~ 2147483646	현재 캐파시티 이 저장 영역에서 이 플레이어가 현재 이용할 수 있는 폼 저장 슬롯 수입니다. 초기값은 저장 영역 모델의 initialMaxCapacity로 설정되며, 캐파시티 증가 조작을 통해 maxCapacity까지 확장할 수 있습니다.

마스터 데이터 작성 예

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

GS2-Idle Buff 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

Note

버프 엔트리 모델에 대한 자세한 내용은 BuffEntryModel을 참조해 주세요.

Models

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

Gs2Idle:Status

스테이터스

버프 적용 대상 필드

maximumIdleMinutes

	타입	활성화 조건	필수	기본값	값 제한	설명
maximumIdleMinutes	int			0	0 ~ 2147483646	최대 방치 시간(분) 이 스테이터스가 축적할 수 있는 최대 방치 시간(분)입니다. 스테이터스 생성 시 카테고리 모델의 defaultMaximumIdleMinutes 로 초기화됩니다. 입수 액션을 통해 사용자별로 늘릴 수 있으며, 프리미엄 사용자나 이벤트 참가자가 더 많은 방치 보상을 축적할 수 있도록 합니다.

마스터 데이터 작성 예

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

GS2-Inventory Buff 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

Note

버프 엔트리 모델에 대한 자세한 내용은 BuffEntryModel을 참조해 주세요.

Models

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

Gs2Inventory:Inventory

인벤토리

버프 적용 대상 필드

currentInventoryMaxCapacity

	타입	활성화 조건	필수	기본값	값 제한	설명
currentInventoryMaxCapacity	int		✓		1 ~ 2147483646	최대 용량 이 사용자가 사용할 수 있는 인벤토리 슬롯의 현재 최대 수입니다. 인벤토리 모델의 initialCapacity로 초기화되며, 입수 액션 또는 직접적인 API 호출을 통해 모델의 maxCapacity까지 확장할 수 있습니다.

마스터 데이터 작성 예

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

GS2-Limit Buff 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

Note

버프 엔트리 모델에 대한 자세한 내용은 BuffEntryModel을 참조해 주세요.

Action

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

Gs2Limit:CountUp

카운트업

요청한 사용자의 카운터를 지정된 카운트업 값만큼 증가시킵니다.
maxValue가 지정된 경우, 카운터는 해당 상한을 초과하지 않습니다. 작업이 최대값을 초과하는 경우 Overflow 오류가 반환됩니다.
카운터가 아직 존재하지 않는 경우, 카운트 0으로 자동 생성된 후 증가합니다.

버프 적용 대상 필드

maxValue

Counter - 사용 횟수 제한의 현재 값

	타입	활성화 조건	필수	기본값	값 제한	설명
maxValue	int				1 ~ 2147483646	카운트업을 허용하는 최댓값

마스터 데이터 작성 예

"targetAction": {
    "targetActionName": "Gs2Limit:CountUp",
    "targetFieldName": "maxValue",
    "conditionGrns": [
    ],
    "rate": 1.0
}

버프 적용 조건 모델

Gs2Limit:LimitModel

횟수 제한 모델

GS2-LoginReward Buff 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

Note

버프 엔트리 모델에 대한 자세한 내용은 BuffEntryModel을 참조해 주세요.

Models

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

Gs2LoginReward:BonusModel

로그인 보너스 모델

버프 적용 대상 필드

acquireActions

	타입	활성화 조건	필수	기본값	값 제한	설명
acquireActions	List<AcquireAction>		✓		1 ~ 10 items	입수 액션 목록 이 날짜의 보상으로 사용자에게 부여되는 리소스를 정의하는 입수 액션 목록. 각 액션은 입수 액션(아이템 추가, 화폐 부여 등)과 그 요청 파라미터를 지정합니다. 보상당 최소 1개, 최대 10개의 액션을 설정할 수 있습니다.

마스터 데이터 작성 예

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

GS2-Mission Buff 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

Note

버프 엔트리 모델에 대한 자세한 내용은 BuffEntryModel을 참조해 주세요.

Models

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

Gs2Mission:MissionTaskModel

미션 태스크 모델

버프 적용 대상 필드

completeAcquireActions

	타입	활성화 조건	필수	기본값	값 제한	설명
completeAcquireActions	List<AcquireAction>			[]	0 ~ 100 items	미션 달성 시 보상 플레이어가 미션 달성 보상을 받을 때 실행되는 입수 액션의 목록입니다.

마스터 데이터 작성 예

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

GS2-Money Buff 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

Note

버프 엔트리 모델에 대한 자세한 내용은 BuffEntryModel을 참조해 주세요.

Action

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

Gs2Money:DepositByUserId

사용자 ID를 지정하여 지갑 잔액에 가산

지정한 사용자의 지갑에 지정한 양의 통화를 추가합니다.
가격이 0인 경우는 무료 통화로, 그 외의 경우는 유료 통화로 취급됩니다.

버프 적용 대상 필드

count

Wallet - 지갑

	타입	활성화 조건	필수	기본값	값 제한	설명
count	int		✓		1 ~ 2147483646	지급할 유료 통화 수량

마스터 데이터 작성 예

"targetAction": {
    "targetActionName": "Gs2Money:DepositByUserId",
    "targetFieldName": "count",
    "conditionGrns": [
    ],
    "rate": 1.0
}

버프 적용 조건 모델

Gs2Money:Wallet

지갑

GS2-Money2 Buff 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

Note

버프 엔트리 모델에 대한 자세한 내용은 BuffEntryModel을 참조해 주세요.

Action

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

Gs2Money2:DepositByUserId

사용자 ID를 지정하여 지갑 잔액에 가산

지정된 사용자의 지갑에 지정된 입금 트랜잭션을 추가합니다.
각 입금 트랜잭션에 대해 이벤트 로그가 기록됩니다.

버프 적용 대상 필드

count

DepositTransaction - 입금 트랜잭션

	타입	활성화 조건	필수	기본값	값 제한	설명
count	int		✓		0 ~ 2147483646	과금 통화 수량 이 입금에서의 가상 통화 단위 수입니다. 지갑에서 출금되면 감소합니다.

마스터 데이터 작성 예

"targetAction": {
    "targetActionName": "Gs2Money2:DepositByUserId",
    "targetFieldName": "count",
    "conditionGrns": [
    ],
    "rate": 1.0
}

버프 적용 조건 모델

Gs2Money2:Wallet

지갑

GS2-Quest Buff 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

Note

버프 엔트리 모델에 대한 자세한 내용은 BuffEntryModel을 참조해 주세요.

Models

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

Gs2Quest:QuestModel

퀘스트 모델

버프 적용 대상 필드

completeAcquireActions

	타입	활성화 조건	필수	기본값	값 제한	설명
completeAcquireActions	List<AcquireAction>			[]	0 ~ 10 items	클리어 보상 획득 액션 이 콘텐츠 배리에이션으로 퀘스트를 클리어했을 때 실행되는 획득 액션입니다. 플레이어가 퀘스트 클리어 시 받게 되는 실제 보상을 정의합니다.

마스터 데이터 작성 예

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

GS2-Showcase Buff 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

Note

버프 엔트리 모델에 대한 자세한 내용은 BuffEntryModel을 참조해 주세요.

Models

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

Gs2Showcase:DisplayItem

진열 상품

버프 적용 대상 필드

acquireActions

	타입	활성화 조건	필수	기본값	값 제한	설명
acquireActions	List<AcquireAction>			[]	1 ~ 100 items	획득 액션 리스트 구매 보상으로 리소스를 부여하는 액션입니다. 모든 소비 액션이 정상적으로 완료된 후에 실행됩니다.

마스터 데이터 작성 예

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

GS2-SkillTree Buff 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

Note

버프 엔트리 모델에 대한 자세한 내용은 BuffEntryModel을 참조해 주세요.

Models

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

Gs2SkillTree:NodeModel

노드 모델

버프 적용 대상 필드

releaseVerifyActions

	타입	활성화 조건	필수	기본값	값 제한	설명
releaseVerifyActions	List<VerifyAction>			[]	0 ~ 10 items	해방 검증 액션 목록 이 노드를 해방하기 전에 실행되어 조건이 충족되었는지 확인하는 검증 액션의 목록입니다. 예를 들어 플레이어가 특정 레벨에 도달했는지, 특정 아이템을 소지하고 있는지를 검증할 수 있습니다. 검증 액션 중 하나라도 실패하면 노드 해방이 거부됩니다. 최대 10개 액션.

마스터 데이터 작성 예

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

GS2-Stamina Buff 레퍼런스

Mon, 01 Jan 0001 00:00:00 +0000

Note

버프 엔트리 모델에 대한 자세한 내용은 BuffEntryModel을 참조해 주세요.

Models

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

Gs2Stamina:Stamina

스태미나

버프 적용 대상 필드

maxValue

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

마스터 데이터 작성 예

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