stage_bind_physics
Links visual scene objects to physics bodies so physics simulations drive object animations for realistic motion in 3D scenes.
Instructions
Bind a scene object to a physics body.
Links a visual object to a physics simulation body so that
the physics simulation drives the object's animation.
Args:
scene_id: Scene identifier
object_id: Scene object ID
physics_body_id: Physics body ID from chuk-mcp-physics
Format: "rapier://sim-{sim_id}/body-{body_id}"
Example: "rapier://sim-abc123/body-ball"
Returns:
BindPhysicsResponse confirmation
Tips for LLMs:
- Create physics body first using chuk-mcp-physics
- Then create matching scene object with same shape/size
- Bind them together so physics drives visuals
- Use stage_bake_simulation to convert physics → keyframes
Example:
# 1. Create physics simulation (chuk-mcp-physics)
sim = await create_simulation(gravity_y=-9.81)
# 2. Add physics body
await add_rigid_body(
sim_id=sim.sim_id,
body_id="ball",
body_type="dynamic",
shape="sphere",
radius=1.0,
position=[0, 5, 0]
)
# 3. Create scene object
await stage_add_object(
scene_id=scene_id,
object_id="ball",
object_type="sphere",
radius=1.0,
position_y=5.0
)
# 4. Bind them
await stage_bind_physics(
scene_id=scene_id,
object_id="ball",
physics_body_id=f"rapier://{sim.sim_id}/body-ball"
)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| scene_id | Yes | ||
| object_id | Yes | ||
| physics_body_id | Yes |