configure_world
Configures the active Blender world background, including color, emission strength, node-tree activation, physical sky models, and environment image rotation for scene lighting.
Instructions
Configure the active world background settings (color, strength, and node-tree activation).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "configure_world"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| color | No | RGB background color components [r, g, b] normalized to 0.0-1.0. | |
| task_id | No | Optional task or workflow identifier for grouping related scene mutation operations. | |
| altitude | No | Observer altitude above sea level in meters [0.0 to 100000.0] (Nishita). Default 100.0. | |
| 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. | |
| sky_type | No | Optional physical sky model type: 'MULTIPLE_SCATTERING' (Nishita Multiple Scattering), 'SINGLE_SCATTERING', 'PREETHAM', 'HOSEK_WILKIE', or 'NISHITA' (alias for MULTIPLE_SCATTERING). | |
| strength | No | Background emission strength multiplier (>= 0.0). | |
| sun_disc | No | Whether to render the visible sun disc in the physical sky (Nishita). | |
| sun_size | No | Angular diameter of the sun disc in radians [0.0 to 1.5708] (Nishita). Default ~0.009512 rad (0.545 deg). | |
| turbidity | No | Atmospheric turbidity [1.0 to 10.0] for Preetham/Hosek-Wilkie models. Default 2.2. | |
| use_nodes | No | Whether the world shader uses an active node tree. | |
| air_density | No | Air molecule density multiplier (Rayleigh scattering) [0.0 to 1000.0] (Nishita). Default 1.0. | |
| sun_rotation | No | Solar azimuth rotation angle in radians [-6.2832 to 6.2832] (Nishita). Default 0.0. | |
| ground_albedo | No | Ground albedo reflection factor [0.0 to 1.0] for Preetham/Hosek-Wilkie models. Default 0.3. | |
| ozone_density | No | Ozone layer density multiplier (Ozone absorption) [0.0 to 1000.0] (Nishita). Default 1.0. | |
| sun_elevation | No | Solar elevation angle above the horizon in radians [-1.5708 to 1.5708] (Nishita). Default ~0.2618 rad (15 deg). | |
| sun_intensity | No | Multiplier for the sun disc brightness (>= 0.0, default 1.0) (Nishita). | |
| aerosol_density | No | Aerosol / haze / dust particle density multiplier (Mie scattering) [0.0 to 1000.0] (Nishita). Default 1.0. | |
| environment_image | No | Optional image datablock name or absolute filepath to bind to an environment texture background node. | |
| environment_rotation | No | Rotation for the environment texture (HDRI) or background mapping. Either a single float (rotation angle around Z-axis in radians) or a 3-element list [rx, ry, rz] in radians. |