Timed events: a festival with a prize track

What the player sees

• Every active event as a tab with its name and timer.
• The token bar to the next prize and the milestone track.
• A VIP second prize on milestones; a pass bought later tops up the milestones already claimed.
• "Claim all" and a popup with how tokens are earned and their daily caps.

How it works

• Tokens come from sources set on the event: an action in the game, a purchase, a quest and others.
• A round of play is a custom action the game reports; the minimal template does that for every event that lists it.
• "Get VIP" opens the VIP screen when it is installed.

For developers

Timed events work through client.timedEvent in @idosgames/core.

// A round was played: tokens for the 'play_round' action of every active event
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',
    })
// Claim every waiting milestone of every event in one call
await client.timedEvent.claimAllMilestones()

• The game grants tokens only through the sources set on the event; the server applies the caps.
• Read the track from getActiveEvents(): claimed milestones are kept there.

Every field is described in the timed-event-system skill, served by the SDK MCP server.