setup_physics
Add or configure rigid body, cloth, or collision physics on a Blender object with mass, friction, restitution, and presets.
Instructions
Configure physics simulations on a scene object: Rigid Body dynamics (Active/Passive, mass, friction, restitution, collision shape), Cloth simulation modifier (presets: SILK, COTTON, LEATHER, pinning vertex group, quality), or Collision body (damping, cloth friction, thickness).
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": {
"object_name": "<object_name>"
},
"name": "setup_physics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mass | No | Rigid body or cloth mass in kilograms (0.01 to 10000.0). | |
| action | No | Action to perform (add, remove, configure). | add |
| damping | No | Collision damping factor (0.0 to 1.0). | |
| quality | No | Cloth simulation quality steps per frame (1 to 20). | |
| task_id | No | Optional task or workflow identifier. | |
| approved | No | DEPRECATED / UNTRUSTED: Client-supplied approval flags in tool arguments are not trusted as proof of human consent. | |
| friction | No | Surface friction coefficient (0.0 to 1.0 for rigid bodies; 0.0 to 80.0 for cloth collision). | |
| kinematic | No | Whether the rigid body is animated / kinematic (driven by animation/script rather than physics forces). | |
| object_name | Yes | Name of the target object to attach or configure physics on. | |
| restitution | No | Bounciness / restitution coefficient (0.0 to 1.0). | |
| cloth_preset | No | Optional physical cloth preset setting stiffness, shear, and density parameters. | |
| distance_min | No | Minimum distance between cloth and external collision objects in meters (0.001 to 1.0). | |
| physics_type | No | Physics system type. | RIGID_BODY |
| use_breaking | No | Allow the constraint to break when impulse exceeds breaking_threshold. | |
| use_pressure | No | Enable or disable uniform cloth internal gas pressure simulation. | |
| self_friction | No | Friction coefficient for cloth self-collision (0.0 to 80.0). | |
| target_volume | No | Target volume factor when use_pressure_volume is enabled (0.0 to 10000.0). | |
| use_collision | No | Enable or disable cloth object collision with other collision objects. | |
| cloth_friction | No | Collision surface friction against cloth (0.0 to 80.0). | |
| linear_damping | No | Amount of linear velocity lost over time for rigid body (0.0 to 1.0). | |
| angular_damping | No | Amount of angular velocity lost over time for rigid body (0.0 to 1.0). | |
| collision_shape | No | Rigid body collision boundary shape. | CONVEX_HULL |
| constraint_type | No | Rigid body constraint type (FIXED, POINT, HINGE, SLIDER, GENERIC). | FIXED |
| pressure_factor | No | Pressure scaling factor (0.0 to 10000.0). | |
| rigid_body_type | No | Rigid body simulation type (ACTIVE or PASSIVE). | ACTIVE |
| target_object_1 | No | First object connected by the rigid body constraint (defaults to object_name if omitted). | |
| target_object_2 | No | Second object connected by the rigid body constraint (optional; connects to world if omitted). | |
| thickness_outer | No | Outer collision distance around mesh surface (0.001 to 1.0). | |
| use_limit_ang_x | No | Enable angular rotation limit around the X axis. | |
| use_limit_ang_y | No | Enable angular rotation limit around the Y axis. | |
| use_limit_ang_z | No | Enable angular rotation limit around the Z axis. | |
| use_limit_lin_x | No | Enable linear translation limit along the X axis. | |
| use_limit_lin_y | No | Enable linear translation limit along the Y axis. | |
| use_limit_lin_z | No | Enable linear translation limit along the Z axis. | |
| pin_vertex_group | No | Optional vertex group name used for mass pinning in cloth simulation. | |
| collision_quality | No | Collision quality steps for cloth collision solver (1 to 20). | |
| limit_ang_x_lower | No | Lower angular rotation limit around the X axis in radians (-100.0 to 100.0). | |
| limit_ang_x_upper | No | Upper angular rotation limit around the X axis in radians (-100.0 to 100.0). | |
| limit_ang_y_lower | No | Lower angular rotation limit around the Y axis in radians (-100.0 to 100.0). | |
| limit_ang_y_upper | No | Upper angular rotation limit around the Y axis in radians (-100.0 to 100.0). | |
| limit_ang_z_lower | No | Lower angular rotation limit around the Z axis in radians (-100.0 to 100.0). | |
| limit_ang_z_upper | No | Upper angular rotation limit around the Z axis in radians (-100.0 to 100.0). | |
| limit_lin_x_lower | No | Lower linear translation limit along the X axis in meters (-10000.0 to 10000.0). | |
| limit_lin_x_upper | No | Upper linear translation limit along the X axis in meters (-10000.0 to 10000.0). | |
| limit_lin_y_lower | No | Lower linear translation limit along the Y axis in meters (-10000.0 to 10000.0). | |
| limit_lin_y_upper | No | Upper linear translation limit along the Y axis in meters (-10000.0 to 10000.0). | |
| limit_lin_z_lower | No | Lower linear translation limit along the Z axis in meters (-10000.0 to 10000.0). | |
| limit_lin_z_upper | No | Upper linear translation limit along the Z axis in meters (-10000.0 to 10000.0). | |
| self_distance_min | No | Minimum distance between colliding cloth faces/vertices in meters (0.0005 to 0.1). | |
| breaking_threshold | No | Threshold of linear/angular impulse required to break the constraint (0.0 to 100000.0). | |
| disable_collisions | No | Disable collisions between the two constrained objects. | |
| use_self_collision | No | Enable or disable cloth self-collision. | |
| use_pressure_volume | No | Auto-adjust pressure to preserve or target a specific volume. | |
| expected_snapshot_id | No | Expected state snapshot ID for optimistic concurrency control. | |
| use_internal_springs | No | Enable or disable cloth internal spring generation across 3D mesh volume. | |
| uniform_pressure_force | No | Uniform pressure force applied outwards in Pascals (-10000.0 to 10000.0; positive inflates, negative deflates). | |
| internal_spring_max_length | No | Maximum length of internal springs in meters (0.0 means unconstrained / no limit; 0.0 to 1000.0). | |
| internal_tension_stiffness | No | Tension stiffness of internal springs (0.0 to 10000.0). | |
| internal_spring_normal_check | No | Check that internal springs align with face normals to avoid inverted springs. | |
| internal_compression_stiffness | No | Compression stiffness of internal springs (0.0 to 10000.0). |