entity.align

Since next

Move an entity so points on it land on matching points elsewhere (a modelled part onto a scan): world-space pairs, 3+; rigid, or with one uniform scale.

Plain text

Answers the RMS residual; apply false only measures. ground: true drops it onto what is below instead (a road's surface or the terrain if the scene has one, even with no editor); tilt: true also turns it to the slope.


Title	Align an entity onto matching points
Mode	`editor`
Token cost	about 246 tokens (listed only when its toolset is enabled)
Toolset	`assets`

Arguments

Argument	Type	Required	Default	Description
`apply`	`boolean`	no	`true`	`false` writes nothing and reports what would change.
`entity`	`string`	yes
`ground`	`boolean`	no
`part`	`number[][]`	no		Points on the entity, world space
`scan`	`number[][]`	no		The matching points, same order
`similarity`	`boolean`	no	`false`
`tilt`	`boolean`	no

Example

An MCP tools/call with the required arguments (placeholders in angle brackets).

{
  "name": "entity.align",
  "arguments": {
    "entity": "<entity>"
  }
}