Command · physics2d

physics2d.set

Set a validated 2D rigid body (body + collider) or capsule character, with its pose.

scope edit:scenenot idempotentnon-destructive

Params

Typed as Physics2dSetParams. Fields marked * are required.

entity*

entity

Target entity, including prefab addresses.

required

pose*

PhysicsPose2d

World-space starting pose.

required

body

option<RigidBody2d>

Rigid body settings; requires collider and excludes character.

default null

collider

option<Collider2d>

Collision geometry and material for body.

default null

character

option<CharacterController2d>

Capsule character controller; excludes body and collider.

default null

Examples

JSON (MCP ara_apply, batches)

{
  "cmd": "physics2d.set",
  "args": {
    "entity": "e_crate1",
    "pose": {
      "position": [
        2,
        1
      ]
    },
    "body": {
      "motion": "dynamic"
    },
    "collider": {
      "halfExtents": [
        0.5,
        0.5
      ]
    }
  }
}

CLI

ara do physics2d.set --args '{"entity":"e_crate1","pose":{"position":[2,1]},"body":{"motion":"dynamic"},"collider":{"halfExtents":[0.5,0.5]}}' --why "…"

JSON (MCP ara_apply, batches)

{
  "cmd": "physics2d.set",
  "args": {
    "entity": "e_hero1",
    "pose": {
      "position": [
        0,
        1
      ]
    },
    "character": {
      "height": 1.4
    }
  }
}

CLI

ara do physics2d.set --args '{"entity":"e_hero1","pose":{"position":[0,1]},"character":{"height":1.4}}' --why "…"