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

# GS2-Limit API 레퍼런스

횟수 제한 기능




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

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

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

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

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

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

[마이크로서비스 소개 / GS2-Limit](../../microservices/limit)



- [GS2-Limit Buff 레퍼런스](/ko/api_reference/limit/buff/)
  
- [GS2-Limit Deploy/CDK 레퍼런스](/ko/api_reference/limit/deploy/)
  
- [GS2-Limit SDK API 레퍼런스](/ko/api_reference/limit/sdk/)
  
- [GS2-Limit SDK for Game Engine API 레퍼런스](/ko/api_reference/limit/game_engine/)
  
- [GS2-Limit 마스터 데이터 레퍼런스](/ko/api_reference/limit/master_data/)
  
- [GS2-Limit 스크립트 트리거 레퍼런스](/ko/api_reference/limit/script/)
  
- [GS2-Limit 트랜잭션 액션](/ko/api_reference/limit/stamp_sheet/)