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

# GS2-Idle API 레퍼런스

방치 보상 기능




방치 보상을 실현하기 위한 서비스입니다.<br>
게임을 플레이하지 않은 시간에 따라 보상을 획득할 수 있는 구조를 실현합니다.

방치 보상은 여러 개를 준비할 수 있습니다.<br>
플레이어는 카테고리별로 1개의 대기 시간을 가질 수 있습니다.

카테고리는 "캐릭터의 스태미나 자연 회복", "채굴장의 자동 채굴", "소재의 자동 생성" 등, 각각 독립된 방치 보상의 단위로 활용할 수 있습니다.

카테고리에는 대기 시간(몇 분마다 보상을 얻을 수 있는지)과 대기 시간 최댓값의 초깃값을 설정할 수 있습니다.<br>
대기 시간의 최댓값은 플레이어별로 늘릴 수 있습니다. 보상 수령 후에 미소진된 대기 시간을 초기화할지 다음으로 이월할지는 `rewardResetMode`로 선택할 수 있습니다.

방치 보상에는 대기 시간이 일정 시간 경과하면 얻을 수 있는 아이템 목록을 정의합니다.<br>
지급하는 보상은 "경험치+아이템"처럼 여러 개(최대 10개)를 설정할 수 있습니다.

보상 내용에 좀 더 무작위성을 부여하고 싶은 경우가 있습니다.<br>
그러한 경우에는 보상에 GS2-Lottery의 추첨 처리를 설정해 주세요.

이벤트와 연동한 방치 보상을 구현할 수 있도록, 카테고리별로 GS2-Schedule의 이벤트와 연결할 수 있습니다.

GS2-Buff를 이용하면, 카테고리 모델의 `acquireActions`나 플레이어별 `maximumIdleMinutes`를 버프로 보정하여, 이벤트나 캠페인에 따라 대기 중 보상 내용이나 상한 시간을 동적으로 조정할 수 있습니다.

예를 들어 "주말에는 방치 보상 1.5배", "특정 칭호를 보유한 플레이어는 최대 방치 시간 +60분"과 같은 운용이 가능합니다.

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



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