game_cameras

4 public commands in this category.

• camera_shake

  Trigger a camera shake effect on the active game camera

  Scope: scene:write. Token cost: 0.

  duration number (required)

  Shake duration in seconds

  entityId string (required)

  Entity ID of the game camera

  intensity number (required)

  Shake intensity (0.0-1.0)

• get_game_camera

  Get game camera configuration for an entity

  Scope: scene:read. Token cost: 0.

  entityId string (required)

  Entity ID to query

• set_active_game_camera

  Set which entity is the active game camera for play mode

  Scope: scene:write. Token cost: 0.

  entityId string (required)

  Entity ID to make active camera (or null to clear)

• set_game_camera

  Set or update game camera configuration on an entity

  Scope: scene:write. Token cost: 0.

  entityId string (required)

  Entity ID to configure camera on

  mode string (required)

  Camera mode. Selects which of the parameters below apply; every parameter is optional and an omitted one takes the engine's default for that mode

  autoRotate boolean (optional)

  Orbit continuously without input (orbital, default true)

  autoRotateSpeed number (optional)

  Auto-rotation speed in degrees per second (orbital, default 15)

  collisionAvoidance boolean (optional)

  Pull the camera in when geometry blocks the shot (thirdPersonFollow, default true)

  damping number (optional)

  Movement smoothing (thirdPersonFollow / sideScroller / topDown, default 5)

  eyeHeight number (optional)

  Eye height above the entity origin (firstPerson, default 1.7)

  followRotation boolean (optional)

  Rotate with the target instead of holding world axes (topDown, default false)

  followY boolean (optional)

  Track the target vertically as well as horizontally (sideScroller, default true)

  fov number (optional)

  Vertical field of view in degrees (firstPerson, default 75)

  height number (optional)

  Height above the target (topDown, default 15)

  lookAt array (optional)

  World point the camera aims at as [x, y, z] (fixed; holds its current rotation when omitted)

  lookAtTarget boolean (optional)

  Aim the camera at its target rather than holding a fixed rotation (thirdPersonFollow, default true)

  maxDistance number (optional)

  Furthest the camera may sit from its target; must not be below minDistance (thirdPersonFollow, default 10)

  minDistance number (optional)

  Closest the camera may sit to its target (thirdPersonFollow, default 2)

  mouseSensitivity number (optional)

  Mouse look sensitivity (firstPerson, default 0.1)

  offset array (optional)

  Camera offset from target as [x, y, z] (thirdPersonFollow, default [0, 2, -5])

  pitchClamp array (optional)

  Pitch limits as [min, max] degrees, min <= max (firstPerson, default [-89, 89])

  radius number (optional)

  Orbit radius (orbital, default 8)

  targetEntity string (optional)

  Entity ID to follow/track (optional)

  yBounds array (optional)

  Vertical travel limits as [min, max], min <= max (sideScroller, unbounded when omitted)

  zOffset number (optional)

  Distance from the play plane (sideScroller, default 10)