게임 내 퀘스트: 일일 과제와 보상

플레이어가 보는 것

• 탭으로 된 주기: 일일, 주간, 업적, 다음 주기까지의 타이머.
• 과제마다 진행 바와 모든 목표가 나오는 상세 창.
• 끝난 과제를 위한 "모두 받기" 버튼.
• 포인트가 쌓이면 상자가 열리는 포인트 트랙.
• 끝난 과제가 기다릴 때 탭의 배지.

퀘스트의 구조

• 주기: 일정이 있는 과제 묶음. 일일, 주간, 상시 또는 기간 한정 이벤트. 주기는 단계별로 이어질 수 있습니다. 예를 들어 8주짜리 시즌에서 주마다 자기 과제와 포인트 트랙이 있습니다.
• 퀘스트: 각자 카운터가 있는 목표 하나 이상("몬스터 20마리 처치")과 보상. 퀘스트는 다른 퀘스트를 먼저 끝내도록 요구할 수 있고, 그렇게 연속 퀘스트를 만듭니다.

보상은 세 가지이며 모두 동시에 작동합니다:

1. 퀘스트 보상: 모든 목표를 끝냈을 때.
2. 포인트 트랙의 상자: 받은 퀘스트가 주기 포인트를 더하고, 필요한 합계에서 상자가 열립니다.
3. 그룹 보너스: 한 그룹의 퀘스트를 정해진 수만큼 끝냈을 때.

진행도는 어디서 오나

개발자용

퀘스트는 @idosgames/core의 client.quest로 작동합니다. 진행도는 퀘스트가 아니라 카운터 이름으로 보냅니다. 서버가 그 카운터를 듣는 모든 진행 중인 과제에 전달합니다.

// 일이 일어나는 곳: 몬스터를 처치함
await client.quest.addQuestProgress('monsters_defeated', 1)

// 퀘스트 화면: 플레이어의 진행도, 주기는 알아서 넘어갑니다
const state = await client.quest.getUserQuestState()

// 끝난 퀘스트의 보상 받기
const claim = await client.quest.claimQuestReward('daily_win_20', 'daily')
if (!claim.ok) return showError(claim.error)

• addQuestProgress는 출처가 게임인 목표만 움직입니다. 서버가 직접 세는 목표는 거부됩니다.
• 값을 "혹시 몰라서" 보내지 마세요. 목표에 호출당 최대치가 있으면 넘었을 때 플레이어 계정이 차단됩니다.
• 지급된 보상은 SDK 캐시의 잔액에 이미 반영되어 있어 다시 불러올 필요가 없습니다.

모든 필드는 SDK의 MCP 서버가 제공하는 quest-system 스킬에 설명되어 있습니다.