Add a 3D object to the live scene. Returns the assigned id. Always call getSceneState first to understand what already exists.

Update any properties of an existing 3D object. Supports partial updates.

Remove a 3D object from the scene by id.

Duplicate an object with an optional position offset.

Get properties of a single scene object by id.

Get the full current scene state: all objects, lights, camera, and environment. Call this first before making any changes.

Add a light to the scene.

Update an existing light by id.

Remove a light from the scene by id.

Set the camera position and look-at target.

Smoothly move the camera to look at an object.

Animate an object property to a target value. Supports transforms (position, rotation, scale) and material properties (emissiveIntensity, opacity, color) for pulsing glow, fading, color shifts.

Stop any running animation on an object.

Configure the scene environment: background, fog, tone mapping, shadows, and post-processing effects.

Create a particle system (stars, dust, sparks, snow, fire embers, laser trails). Uses GPU-efficient point sprites with optional drift animation and twinkle.

Update properties of an existing particle system.

Remove a particle system from the scene.

Execute arbitrary JavaScript code in the connected browser scene context. The code runs inside an async function with access to: scene (THREE.Scene), camera, renderer, controls, and a helpers object. Return a value to send it back. Use this for advanced effects the other tools cannot achieve — custom shaders, complex geometry, procedural generation, physics, etc.

Attach a continuous frame-tick behavior to an object. Behaviors run every frame until removed. Types: spin (rotate continuously), bob (oscillate up/down), orbit (circle around a point), lookAt (always face camera), pulse (rhythmic scale breathing).

Remove a behavior by its ID, stopping its frame-tick effect.

Remove all user-created objects from the scene and reset default lighting.

Replace the entire scene with a previously exported scene JSON.

Export the current scene as a JSON string (can be stored and re-loaded later).

Save the current scene to a JSON file in the scenes/ folder. Returns the file path.

List all saved scene JSON files in the scenes/ folder.

Load a previously saved scene from the scenes/ folder by name.

Export the current scene as a standalone HTML file that plays in any browser without a server. Includes all objects, lights, materials, animations, camera, and environment. No chat UI. Saved to the scenes/ folder. Returns the file path.

Undo the last scene change (up to 20 levels).

Redo a previously undone scene change.

Capture the current 3D viewport and return a base-64 PNG data URL. Requires a browser client to be connected.

Return any in-world chat messages the user has typed from inside the 3D environment. Call this at the start of every turn to check for user input from the canvas.

Display a message in the in-world chat overlay visible to the user inside the 3D view.

Clear all queued in-world user messages (useful after processing a batch).