configure_particle_system
Create, configure, inspect, or remove emitter and hair particle systems on Blender mesh objects, including count, lifetime, velocity, hair dynamics, and instancing, with rollback support.
Instructions
Create, configure, inspect, or remove emitter or hair particle systems on mesh objects with full parameter controls (count, lifetime, initial velocity, hair dynamics cloth solver, object/collection instancing) 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_particle_system"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mass | No | Mass of individual particles in kg (0.00001 to 10000.0). Defaults to 1.0. | |
| name | No | Alias for object_name. | |
| count | No | Total number of emitted particles (1 to 1000000). Defaults to 1000. | |
| action | No | Action to perform: 'create'/'add', 'configure', 'inspect', or 'remove'/'delete'. Defaults to 'create'. | create |
| 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. | |
| lifetime | No | Lifetime of particles in frames (0.1 to 100000.0). Defaults to 50.0. | |
| frame_end | No | Ending frame for particle emission. Defaults to 200.0. | |
| hair_step | No | Number of hair segments/keys per strand (1 to 7). Used when system_type is HAIR. Defaults to 5. | |
| frame_start | No | Starting frame for particle emission. Defaults to 1.0. | |
| hair_length | No | Length of hair strands in meters (0.0001 to 10000.0). Used when system_type is HAIR. Defaults to 4.0. | |
| object_name | No | Name of the target mesh object (alias: name). | |
| render_type | No | Particle visualization/instancing render type. Defaults to HALO. | HALO |
| size_random | No | Random size variation factor (0.0 to 1.0). Defaults to 0.0. | |
| snapshot_id | No | Alias for expected_snapshot_id. | |
| system_name | No | Name of the particle system (default: 'ParticleSystem'). | ParticleSystem |
| system_type | No | Particle system type ('EMITTER' or 'HAIR'). Defaults to 'EMITTER'. | EMITTER |
| physics_type | No | Particle physics solver type. Defaults to NEWTON. | NEWTON |
| factor_random | No | Random velocity perturbation factor (0.0 to 1000.0). Defaults to 0.0. | |
| normal_factor | No | Initial velocity along surface normal (-1000.0 to 1000.0). Defaults to 1.0. | |
| object_factor | No | Emitter object movement velocity factor (0.0 to 1000.0). Defaults to 0.0. | |
| particle_size | No | Display/instance size of particles in meters (0.0001 to 1000.0). Defaults to 0.05. | |
| tangent_factor | No | Initial velocity along surface tangent (-1000.0 to 1000.0). Defaults to 0.0. | |
| delete_settings | No | On removal: whether to delete unlinked ParticleSettings datablock from blender data. Defaults to True. | |
| instance_object | No | Name of object to instance for each particle (used when render_type is OBJECT). | |
| lifetime_random | No | Random variation factor for particle lifetime (0.0 to 1.0). Defaults to 0.0. | |
| use_hair_dynamics | No | Whether physics dynamics (cloth solver) is enabled for hair strands. Defaults to False. | |
| hair_dynamics_mass | No | Hair dynamics mass per strand in kg (0.0001 to 10000.0). Defaults to 1.0. | |
| use_scale_instance | No | Whether instanced object/collection scales with particle size. Defaults to True. | |
| instance_collection | No | Name of collection to instance for particles (used when render_type is COLLECTION). | |
| object_align_factor | No | Initial velocity aligned with object axes [x, y, z]. | |
| use_global_instance | No | Whether to use global coordinates for instanced object. Defaults to False. | |
| expected_snapshot_id | No | Expected state snapshot ID for optimistic concurrency control. | |
| hair_dynamics_quality | No | Hair dynamics simulation solver quality steps (1 to 80). Defaults to 5. | |
| hair_dynamics_air_damping | No | Hair dynamics air damping (0.0 to 10.0). Defaults to 1.0. | |
| hair_dynamics_pin_stiffness | No | Hair dynamics pin stiffness at the root (0.0 to 10000.0). Defaults to 1.0. | |
| hair_dynamics_bending_stiffness | No | Hair dynamics bending stiffness (0.0 to 10000.0). Defaults to 0.5. |