apply_force
Pushes a rigid body through PhysX using a force or impulse, so mass affects motion. Use it to move robots or objects in a running or paused simulation.
Instructions
Push a rigid body through PhysX with a force or an impulse, so its mass counts. The simulation must be playing or paused. A push on an articulation's link, such as a robot's, moves the robot through its joints: a floating robot touching nothing changes speed by the impulse over its whole mass; a fixed robot's link turns about its joints, and on the ground friction takes some of the push. The answer gives the point pushed at and the path the push took: method: physx, PhysX's own push, or method: tensor. With /physics/suppressReadback on, as Isaac Sim's GPU device sets it for PhysX's Direct GPU API, the push goes through PhysX's tensor API. Under that API a second push on a body before the next physics step replaces the first, so push once per body per step, combining pushes into one; pushes on different bodies each land. Refused for a prim without RigidBodyAPI, a disabled or kinematic body, and one a fixed joint holds to the world (a fixed robot's base). To place a body rather than push it, use set_prim_transform.
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": {
"prim_path": "<prim_path>",
"force": "<force>"
},
"name": "apply_force"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| force | Yes | [fx, fy, fz]: an impulse in N s, or a force in N for one physics step | |
| impulse | No | True for an impulse in N s, False for a force in N for one physics step. For a sustained push, give an impulse of force times seconds | |
| position | No | World-space point to push at; the body's centre of mass when omitted | |
| prim_path | Yes | The rigid body's prim path, a robot's link among them |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |