GS2-Limit API 레퍼런스

횟수 제한 처리를 실현하기 위한 서비스

이 서비스는 단독으로 사용하는 것이 아니라, 다른 서비스에서 횟수 제한 기능을 실현하기 위해 사용됩니다.

카운터는 플레이어의 행동 횟수를 표현하기 위한 엔티티로,
카운터의 값을 증가시킬 때 허용 가능한 최댓값을 지정하여 카운트업을 시도함으로써, 최댓값을 초과하는 경우에는 카운트업이 실패하고 후속 처리도 실패시킬 수 있는 메커니즘으로 횟수 제한을 실현합니다.
이때, 카운터 자체에 최댓값이 존재하는 것이 아니라 카운트업 액션에 최댓값을 설정할 수 있다는 점이 특징입니다.

예를 들어, 스태미나 회복 처리를 예로 생각해 봅시다.
많은 게임에서는 하루에 스태미나를 회복할 수 있는 횟수에 상한이 설정되어 있습니다.
그리고 회복을 하면 할수록 회복에 필요한 금액이 상승합니다.

anchorTimestamp 를 활용하면 이벤트 시작일로부터 N일마다 리셋하는 등 유연한 스케줄링이 가능합니다.

GS2-Buff 와 연동하면 CountUp/CountUpByUserId 의 maxValue 를 버프로 보정하여 상한값을 일시적으로 증감시킬 수 있습니다.
“기간 한정으로 하루에 뽑을 수 있는 가챠 횟수를 두 배로 늘린다"와 같이 이벤트에 맞춘 완화 조치를 구현할 때 유용합니다.