Loja no jogo: vitrines, ofertas e preços

O que o jogador vê

• Vitrines em abas. A primeira seção de uma vitrine é um carrossel; as outras são grades de cartões.
• Um presente diário grátis que brilha até ser recolhido.
• Contadores nos cartões: "renova em", "abre em", "esgotado".
• Uma janela de confirmação de compra (um painel inferior no celular).
• A animação "Você ganhou": as recompensas voam até os contadores de saldo.
• Um selo na aba da loja quando há uma oferta grátis à espera.

Como a loja é montada

A loja é uma árvore: vitrine → seções → slots → oferta.

• Oferta: o que é vendido. Preço, recompensas, limites, fitas ("melhor custo", "x2"). As ofertas ficam em um catálogo único.
• Slot: um lugar na prateleira da vitrine. Uma oferta só pode ser comprada por um slot: oferta fora de qualquer slot não é vendida.
• Rodízio: um slot pode mostrar uma oferta de um conjunto e trocá-la por um cronograma, como uma loja diária. O servidor calcula o rodízio, então o jogador vê a mesma loja em qualquer aparelho.

Preços

Você pode mostrar um preço "antigo" riscado, e o servidor calcula o percentual de desconto. Uma oferta pode ter várias opções de preço, por exemplo moedas ou gemas.

Limites de compra

• Para sempre: por exemplo, um pacote inicial uma única vez.
• Por dia: zera à meia-noite UTC.
• Intervalo: a próxima compra só depois de um tempo definido.
• Por janela de rodízio: o limite do slot enquanto esta oferta está na prateleira.

O servidor calcula para cada jogador os selos "primeira compra" e "esgotado" e os contadores.

Para desenvolvedores

A loja funciona por meio de client.store no @idosgames/core. Desenhe a tela a partir de getStorefront(): a vitrine já calculada para este jogador (rodízio, limites, contadores). getDefinitions() é só a configuração, igual para todos.

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 ?? []) {
      // Um slot vazio chega com Offer === null: desenhe uma moldura vazia para a prateleira não pular.
      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 },
})

• Se a compra retornar OFFER_NOT_IN_ROTATION, a vitrine mudou: recarregue-a sem mostrar erro.
• Desative o botão "Comprar" enquanto a requisição estiver em andamento: cada chamada de purchase é uma compra separada.
• Conte os contadores a partir de ServerTimeUtc na resposta, não do relógio do aparelho.
• null em um limite restante significa "sem limite"; 0 significa "esgotado".

Todos os campos estão descritos na habilidade store-system, servida pelo servidor MCP do SDK.