cutscene

5 public commands in this category.

• delete_cutscene

  Permanently delete a cutscene from the project. If the deleted cutscene is currently active, playback is stopped first.

  Scope: scene:write. Token cost: 0.

  cutsceneId string (required)

  ID of the cutscene to delete

• generate_cutscene

  AI-generate a cinematic cutscene timeline from a natural-language description. Produces camera movements, entity animations, dialogue cues, and audio tracks. Returns a cutsceneId to use with play_cutscene. Maximum 60 seconds.

  Scope: scene:write. Token cost: 20.

  prompt string (required)

  Natural-language description of the cutscene, e.g. 'Dramatic pan from sky down to the player, then dialogue between player and the wizard'

  duration number (optional)

  Desired total duration in seconds (1–60, default 10)

• list_cutscenes

  Return all cutscenes saved in the current project, including their IDs, names, durations, and track counts.

  Scope: scene:read. Token cost: 0.

• play_cutscene

  Enter play mode and execute a cutscene timeline. Commands fire at their scheduled timestamps (+/- 16ms). Automatically returns to edit mode when the cutscene ends.

  Scope: scene:write. Token cost: 0.

  cutsceneId string (required)

  ID of the cutscene to play (returned by generate_cutscene or list_cutscenes)

• stop_cutscene

  Stop the currently playing cutscene and return the editor to edit mode. Has no effect if no cutscene is playing.

  Scope: scene:write. Token cost: 0.