configure_light
Update an existing Blender light's type, energy, color, transform, shadow, spot, or area settings in the active scene to adjust scene lighting.
Instructions
Configure properties and transform of an existing light source in the active scene (Point, Sun, Spot, Area). Updates energy, color, location, rotation, spot size/blend, and area size.
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": "configure_light"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Unique name of the existing 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). Must be non-negative. | |
| 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. | |
| spot_blend | No | Soft edge blend factor for SPOT lights (0.0 to 1.0). | |
| 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). |