Eventos temporários: um festival com trilha de prêmios

O que o jogador vê

• Cada evento ativo como uma aba, com nome e tempo.
• A barra de tokens até o próximo prêmio e a trilha de marcos.
• Um segundo prêmio VIP nos marcos; um passe comprado depois completa os marcos já recolhidos.
• "Pegar tudo" e uma janela com como os tokens são ganhos e seus limites diários.

Como funciona

• Os tokens vêm das fontes definidas no evento: uma ação no jogo, uma compra, uma missão e outras.
• Uma rodada de jogo é uma ação personalizada que o jogo informa; o modelo mínimo faz isso para cada evento que a lista.
• "Ser VIP" abre a tela do VIP quando ele está instalado.

Para desenvolvedores

Os eventos temporários funcionam por meio de client.timedEvent no @idosgames/core.

// Uma rodada foi jogada: tokens pela ação 'play_round' de cada evento ativo
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',
    })
// Recolher todos os marcos à espera de todos os eventos em uma chamada
await client.timedEvent.claimAllMilestones()

• O jogo só concede tokens pelas fontes definidas no evento; o servidor aplica os limites.
• Leia a trilha em getActiveEvents(): os marcos recolhidos ficam guardados ali.

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