게임 내 상점: 진열대, 상품, 가격

플레이어가 보는 것

• 탭으로 된 진열대. 진열대의 첫 섹션은 캐러셀이고, 나머지는 카드 그리드입니다.
• 받을 때까지 빛나는 무료 일일 선물.
• 카드의 타이머: "갱신까지", "오픈까지", "품절".
• 구매 확인 창(휴대폰에서는 하단 시트).
• "획득" 애니메이션: 보상이 잔액 카운터로 날아갑니다.
• 무료 상품이 기다릴 때 상점 탭의 배지.

상점의 구조

상점은 트리입니다: 진열대 → 섹션 → 슬롯 → 상품.

• 상품: 파는 것. 가격, 보상, 한도, 리본("최고 가성비", "x2"). 상품은 하나의 카탈로그에 있습니다.
• 슬롯: 진열대 선반의 자리. 상품은 슬롯을 통해서만 살 수 있고, 어느 슬롯에도 없는 상품은 전혀 팔리지 않습니다.
• 교체: 슬롯은 풀에서 상품을 보여 주고 일정에 따라 바꿀 수 있습니다. 오늘의 상점처럼요. 교체는 서버가 계산하므로 플레이어는 어느 기기에서나 같은 상점을 봅니다.

가격

취소선이 그어진 "이전" 가격을 보여 줄 수 있고, 할인율은 서버가 계산합니다. 상품 하나에 여러 가격 옵션을 둘 수도 있습니다. 예를 들어 코인 또는 보석.

구매 한도

• 평생: 예를 들어 스타터 팩은 한 번.
• 하루: UTC 자정에 초기화.
• 쿨다운: 정해진 시간이 지나야 다음 구매.
• 교체 기간당: 이 상품이 선반에 있는 동안의 슬롯 한도.

"첫 구매"와 "품절" 표시와 타이머는 서버가 플레이어마다 계산합니다.

개발자용

상점은 @idosgames/core의 client.store로 작동합니다. 화면은 getStorefront()로 그리세요. 이 플레이어에 맞게 이미 계산된 진열대(교체, 한도, 타이머)입니다. getDefinitions()는 모두에게 같은 설정일 뿐입니다.

const res = await client.store.getStorefront()
if (!res.ok) return showError(res.error)

for (const store of res.data.Stores ?? [])
  for (const section of store.Sections ?? [])
    for (const slot of section.Slots ?? []) {
      // 빈 슬롯은 Offer === null로 옵니다: 선반이 튀지 않도록 빈 틀을 그리세요.
      if (!slot.Offer) continue
      drawCard(slot.Offer, slot.RefreshesAtUtc)
    }

const buy = await client.store.purchase(offer.OfferID, 1, {
  selectedOptionID: option.OptionID,
  slot: { storeID: store.StoreID, sectionID: section.SectionID, slotID: slot.SlotID },
})

• 구매가 OFFER_NOT_IN_ROTATION을 돌려주면 진열대가 바뀐 것입니다. 오류를 보여 주지 말고 다시 불러오세요.
• 요청이 진행되는 동안 "구매" 버튼을 끄세요. purchase 호출 하나하나가 별개의 구매입니다.
• 타이머는 기기 시계가 아니라 응답의 ServerTimeUtc에서부터 세세요.
• 남은 한도의 null은 "한도 없음", 0은 "품절"입니다.

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