Skip to main content
Start with the error code returned by publish. Totem reports every violation it found. Each violation includes a code, a path when a file caused the problem, and a plain remediation sentence.

Complete validation code table

For UNSAFE_PATH, the detail can be empty, backslash, absolute, traversal, dotfile, or node_modules. For DISALLOWED_EXTENSION, a large failure response lists at most 50 offending paths and adds a summary. Upload URLs last 900 seconds. Call request_upload for a fresh URL. Do not retry the expired URL.

My game opens but stays blank

  1. Open the browser console and look for a missing file or JavaScript error.
  2. Confirm asset URLs are relative to the published page.
  3. Match the exact letter case of every archived filename.
  4. Build the production export again.
  5. Archive the contents of the output folder and republish.

My game needs its own backend

Totem does not start server files from a game archive. Keep the published game static and operate any separate network service outside the archive.

My analytics show nothing

Confirm that you opened the current Totem game link, the requested UTC window includes the play, and the API key owns the game.

I lost my API key

Create a replacement, update the MCP client, confirm that the five tools appear, then revoke the lost key. Totem cannot show a key again.

A game is “not found”

Totem returns the same not-found result for a missing game and a game owned by another account. Confirm the game_id and API-key account. This behavior is deliberate.