기간 한정 이벤트: 상품 트랙이 있는 축제

플레이어가 보는 것

• 이름과 타이머가 있는 탭으로 된 진행 중인 모든 이벤트.
• 다음 상품까지의 토큰 바와 마일스톤 트랙.
• 마일스톤의 VIP 두 번째 상품. 나중에 산 패스는 이미 받은 마일스톤을 채워 줍니다.
• **"모두 받기"**와 토큰을 얻는 방법과 일일 한도가 나오는 창.

작동 방식

• 토큰은 이벤트에 정한 출처에서 옵니다: 게임 속 행동, 구매, 퀘스트 등.
• 한 판 플레이는 게임이 알리는 사용자 지정 행동이며, 가장 작은 템플릿은 그것을 목록에 둔 모든 이벤트에 알립니다.
• "VIP 가입"은 VIP가 설치되어 있으면 그 화면을 엽니다.

개발자용

기간 한정 이벤트는 @idosgames/core의 client.timedEvent로 작동합니다.

// 한 판을 했음: 진행 중인 모든 이벤트의 'play_round' 행동에 토큰 지급
const res = await client.timedEvent.getActiveEvents()
for (const e of res.ok ? (res.data.ActiveEvents ?? []) : [])
  if (e.CanEarn !== false && e.Type && e.TimedEventID)
    await client.timedEvent.grantTokens(e.Type, e.TimedEventID, 'CustomAction', undefined, undefined, {
      ActionName: 'play_round',
    })
// 모든 이벤트의 기다리는 마일스톤을 한 번의 호출로 받기
await client.timedEvent.claimAllMilestones()

• 게임은 이벤트에 정한 출처로만 토큰을 주며, 한도는 서버가 적용합니다.
• 트랙은 getActiveEvents()로 읽으세요. 받은 마일스톤이 거기 남아 있습니다.

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