GS2-Idle API 레퍼런스

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

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

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

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

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

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

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

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

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