configure_force_field
Create, configure, inspect, or remove WIND, TURBULENCE, and VORTEX physics force fields with parameter controls and transactional rollback in Blender.
Instructions
Create, configure, inspect, or remove physics force fields (WIND, TURBULENCE, VORTEX) with full parameter controls (strength, flow, wind_factor, size, inflow, noise, seed, falloff, limits) and transactional rollback.
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_force_field"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flow | No | Air flow velocity conversion factor (0.0 to 1000.0). Defaults to 0.0. | |
| name | No | Name of the force field object to create, configure, inspect, or remove (alias: object_name). | |
| seed | No | Random seed for force field noise evaluation (1 to 128). Defaults to 1. | |
| size | No | Size scale of the turbulence perturbation (0.0 to 1000.0, for TURBULENCE). Defaults to 1.0. | |
| noise | No | Amount of noise perturbation added to force strength (0.0 to 10.0). Defaults to 0.0. | |
| shape | No | Directional effector shape calculation. Defaults to POINT. | POINT |
| action | No | Action to perform: 'create'/'add', 'configure', 'inspect', or 'remove'/'delete'. Defaults to 'create'. | create |
| inflow | No | Inwards radial suction component of vortex force (-1000.0 to 1000.0, for VORTEX). Defaults to 0.0. | |
| task_id | No | Optional task identifier. | |
| approved | No | DEPRECATED / UNTRUSTED: Client-supplied approval flags in tool arguments are not trusted as proof of human consent. | |
| location | No | World coordinate location [x, y, z] for new or transformed force field. | |
| rotation | No | Euler rotation [rx, ry, rz] in radians (defines orientation for directional fields like WIND). | |
| strength | No | Strength of the force field (-100000.0 to 100000.0). Defaults to 1.0. | |
| field_type | No | Force field type: WIND (directional air velocity), TURBULENCE (pseudorandom turbulent disturbance), or VORTEX (spiral vortex flow). | WIND |
| object_name | No | Alias for name. | |
| snapshot_id | No | Alias for expected_snapshot_id. | |
| wind_factor | No | How much the force is reduced when acting parallel to a surface (0.0 to 1.0, e.g. cloth). Defaults to 1.0. | |
| z_direction | No | Effect in full, positive, or negative Z direction. Defaults to BOTH. | BOTH |
| distance_max | No | Maximum distance for field influence (0.0 to 100000.0). Defaults to 0.0. | |
| distance_min | No | Minimum distance for field falloff (0.0 to 1000.0). Defaults to 0.0. | |
| falloff_type | No | Falloff geometry shape. Defaults to SPHERE. | SPHERE |
| use_2d_force | No | Apply force only in the 2D plane perpendicular to local Z. Defaults to False. | |
| delete_object | No | For remove action: whether to delete the empty object itself (True) or only reset field type to NONE (False). Defaults to False. | |
| falloff_power | No | Power of distance falloff curve (0.0 to 10.0). Defaults to 0.0. | |
| use_max_distance | No | Whether to enforce a maximum distance for force influence. Defaults to False. | |
| use_min_distance | No | Whether to enforce a minimum distance for force falloff. Defaults to False. | |
| use_global_coords | No | Use effector global coordinates for turbulence noise evaluation (for TURBULENCE). Defaults to False. | |
| expected_snapshot_id | No | Expected state snapshot ID for optimistic concurrency control. |