Command · physics

physics.collider.fromModel

Derive convex or static mesh collision from cooked model geometry.

scope edit:scenenot idempotentnon-destructive

Params

Typed as ColliderFromModelParams. Fields marked * are required.

entity*

entity

Target entity, including prefab addresses.

required

model

option<asset>

Source import; omitted uses MeshRenderer.model.

default null

node

option<string>

Source node name/index; omitted inherits MeshRenderer.node when model is omitted.

default null

primitive

option<u32>

Subtree-local primitive; omitted inherits MeshRenderer.primitive when model is omitted.

default null

mode

ModelColliderMode

Convex hull by default, or a static triangle surface.

default "convex"

One ofconvexmesh

center

option<vec3>

Optional center in body-local metres, after visual scale is baked.

default null

Examples

JSON (MCP ara_apply, batches)

{
  "cmd": "physics.collider.fromModel",
  "args": {
    "entity": "e_crate",
    "mode": "convex"
  }
}

CLI

ara do physics.collider.fromModel --args '{"entity":"e_crate","mode":"convex"}' --why "…"

JSON (MCP ara_apply, batches)

{
  "cmd": "physics.collider.fromModel",
  "args": {
    "entity": "e_wall",
    "mode": "mesh",
    "center": [
      0,
      0.5,
      0
    ]
  }
}

CLI

ara do physics.collider.fromModel --args '{"entity":"e_wall","mode":"mesh","center":[0,0.5,0]}' --why "…"