SDK API

Reference the frozen window.Totem methods injected into a published game.

window.Totem

window.Totem is frozen. Do not replace it or add properties.

Object.isFrozen(window.Totem) // true

gameOver({ score })

Call this once when a run ends.

window.Totem.gameOver({ score: 12800 })

Input	Type	Rules
score	number	Must be finite. Zero and negative scores are accepted when the game allows them.

An invalid score is ignored and writes a console warning. A valid call records a game_over event and asks the Totem shell to submit the score for the current player.

The shell can reject a score above the game’s configured maximum or more than one score from the same player and game within ten seconds. The game-over screen still keeps Play again available.

event(name, props)

Record a game-specific custom event.

window.Totem.event("level_complete", {
  level: 4,
  elapsed_s: 36
})

props must be JSON-serializable. One event payload can be at most 2,048 bytes. Do not include secrets or direct personal information.

Safe fallback

window.Totem?.gameOver({ score })

This lets the same build run outside a Totem play page.