create_light
Add and position point, sun, spot, or area lights in the active Blender scene with configurable energy, color, size, shadows, and transform settings.
Instructions
Create and position a light source in the active scene (Point, Sun, Spot, Area) with configurable energy, color, and transform.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>"
},
"name": "create_light"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Unique name for the light object. | |
| size | No | Size or radius for AREA and POINT lights in meters. | |
| color | No | RGB light color components [r, g, b] normalized to 0.0-1.0. | |
| shape | No | Shape for AREA lights: 'SQUARE', 'RECTANGLE', 'DISK', or 'ELLIPSE'. | SQUARE |
| energy | No | Light power/energy in Watts (for Sun, typical values are 1-10). | |
| size_y | No | Secondary Y dimension in meters for RECTANGLE and ELLIPSE AREA lights (>= 0.0). | |
| task_id | No | Optional task or workflow identifier for grouping related scene mutation operations. | |
| approved | No | DEPRECATED / UNTRUSTED: Client-supplied approval flags in tool arguments are not trusted as proof of human consent. Mutations must be approved through a trusted approval mechanism. | |
| location | No | 3D world location coordinates [x, y, z]. | |
| spot_size | No | Cone angle in radians for SPOT lights (0.0 to 3.1416). | |
| light_type | No | Type of light source: POINT, SUN, SPOT, or AREA. | POINT |
| use_shadow | No | Whether this light casts shadows in render calculations. | |
| volume_factor | No | Volume scattering contribution factor multiplier (>= 0.0). | |
| diffuse_factor | No | Diffuse reflection contribution factor multiplier (>= 0.0). | |
| rotation_euler | No | Euler rotation angles in radians [rx, ry, rz]. | |
| specular_factor | No | Specular reflection contribution factor multiplier (>= 0.0). | |
| shadow_soft_size | No | Light size for shadow softness radius in meters (>= 0.0). | |
| shadow_buffer_clip_start | No | Near clipping distance for shadow buffer evaluation in meters (>= 0.0001). |