GS2-Mission API 레퍼런스

미션 기능을 제공하는 서비스입니다.

미션 기능은 「n회 퀘스트를 클리어한다」, 「n체의 캐릭터를 입수한다」와 같은 조건을 설정하고, 이를 달성함으로써 보상을 받을 수 있는 구조입니다.
이를 실현하기 위해 “미션의 조건 설정”, “카운터의 구독”, “카운터의 상승"이라는 구조를 사용합니다.

미션의 조건 설정이란, 미션이 달성된 것으로 간주되는 카운터의 임계값을 설정하는 것입니다.

카운터의 구독이란, 미션의 대상이 되는 카운터의 설정입니다.
하나의 카운터는 여러 미션에서 구독할 수 있으며, 미션마다 서로 다른 리셋 타이밍을 설정할 수 있습니다.
예를 들어, 「퀘스트를 통산 1000회 클리어했다」는 미션과, 「퀘스트를 오늘 10회 클리어했다」는 데일리 미션을 만들고 싶은 경우,
퀘스트를 클리어할 때마다 카운트업되는 하나의 카운터를 두 미션 모두에서 구독하고, 전자에는 리셋 없음, 후자에는 매일 리셋 타이밍을 설정함으로써, 한 번의 카운터 조작으로 여러 조건의 미션을 처리할 수 있습니다.

카운터의 상승은 말 그대로 카운터를 상승시키는 조작으로, 예를 들어 퀘스트를 클리어했을 때 퀘스트 클리어 횟수의 카운터 상승을 보상에 포함시켜 사용합니다.

미션에는 두 가지 기간을 설정할 수 있습니다.
첫 번째는 카운터를 조작할 수 있는 기간으로, 카운터를 상승시키는 것을 이벤트 개최 기간으로 한정하는 경우에 사용합니다.
두 번째는 미션 달성 보상 수취 가능 기간으로, 이벤트가 종료된 후에도 한동안 미션 보상만은 받을 수 있도록 하고 싶은 경우 두 기간을 별도로 설정하여 사용합니다.
기간 지정에는 GS2-Schedule 의 이벤트를 연관시킵니다.