mesh

11 public commands in this category.

• array_entity

  Duplicate an entity in a grid (NxMxK) or circular pattern

  Scope: scene:write. Token cost: 0.

  entityId string (required)

  Entity ID to duplicate

  pattern string (required)

  Array pattern: grid or circle

  circleCount integer (optional)

  Number of copies in circle pattern. Default: 8

  circleRadius number (optional)

  Radius of circle pattern. Default: 5.0

  countX integer (optional)

  Grid count along X axis. Default: 3

  countY integer (optional)

  Grid count along Y axis. Default: 1

  countZ integer (optional)

  Grid count along Z axis. Default: 3

  spacingX number (optional)

  Grid spacing along X. Default: 2.0

  spacingY number (optional)

  Grid spacing along Y. Default: 2.0

  spacingZ number (optional)

  Grid spacing along Z. Default: 2.0

• combine_meshes

  Merge multiple mesh entities into a single entity

  Scope: scene:write. Token cost: 0.

  entityIds array (required)

  Array of entity IDs to merge

  deleteSources boolean (optional)

  Delete source entities after combining. Default: true

  name string (optional)

  Name for the combined entity

• csg_intersect

  Compute the intersection of two mesh entities using CSG boolean intersection

  Scope: scene:write. Token cost: 0.

  entityIdA string (required)

  Entity ID of first mesh (A)

  entityIdB string (required)

  Entity ID of second mesh (B)

  deleteSources boolean (optional)

  Delete source entities after operation (default: true)

  name string (optional)

  Name for result entity (auto-generated if omitted)

• csg_subtract

  Subtract mesh B from mesh A using CSG boolean subtraction

  Scope: scene:write. Token cost: 0.

  entityIdA string (required)

  Entity ID of first mesh (A)

  entityIdB string (required)

  Entity ID of second mesh (B)

  deleteSources boolean (optional)

  Delete source entities after operation (default: true)

  name string (optional)

  Name for result entity (auto-generated if omitted)

• csg_union

  Combine two mesh entities using CSG union (boolean add)

  Scope: scene:write. Token cost: 0.

  entityIdA string (required)

  Entity ID of first mesh (A)

  entityIdB string (required)

  Entity ID of second mesh (B)

  deleteSources boolean (optional)

  Delete source entities after operation (default: true)

  name string (optional)

  Name for result entity (auto-generated if omitted)

• extrude_shape

  Create a 3D mesh by extruding a 2D cross-section along a path

  Scope: scene:write. Token cost: 0.

  shape string (required)

  Cross-section shape: circle, square, hexagon, or star

  innerRadius number (optional)

  Inner radius for star shape. Default: 0.25

  length number (optional)

  Length of extrusion along Y-axis. Default: 2.0

  name string (optional)

  Name for the result entity

  position array (optional)

  World position [x, y, z]

  radius number (optional)

  Radius of the cross-section (for circle, hexagon, star outer). Default: 0.5

  segments integer (optional)

  Number of segments for circular shapes. Default: 16

  size number (optional)

  Side length for square shape. Default: 1.0

  starPoints integer (optional)

  Number of points for star shape. Default: 5

• lathe_shape

  Create a 3D mesh by revolving a 2D profile around the Y-axis

  Scope: scene:write. Token cost: 0.

  profile array (required)

  Array of [radius, height] points defining the 2D profile

  name string (optional)

  Name for the result entity

  position array (optional)

  World position [x, y, z]

  segments integer (optional)

  Number of rotational segments (8-64). Default: 32

• mesh_bevel

  Bevel selected mesh edges with specified width and segment count (edit mode)

  Scope: scene:write. Token cost: 0.

  indices array (optional)

  Edge indices to bevel (all selected edges if omitted)

  segments number (optional)

  Number of bevel segments (default: 1)

  width number (optional)

  Bevel width (default: 0.1)

• mesh_delete

  Delete selected mesh elements by mode: face, edge, or vertex (edit mode)

  Scope: scene:write. Token cost: 0.

  indices array (optional)

  Element indices to delete (all selected if omitted)

  mode string (optional)

  Deletion mode (default: face)

• mesh_inset

  Inset selected mesh faces inward by a specified amount (edit mode)

  Scope: scene:write. Token cost: 0.

  amount number (optional)

  Inset distance (default: 0.1)

  indices array (optional)

  Face indices to inset (all selected faces if omitted)

• mesh_loop_cut

  Add loop cuts (subdivisions) along a mesh edge (edit mode)

  Scope: scene:write. Token cost: 0.

  edgeIndex number (required)

  Edge index to cut along

  cuts number (optional)

  Number of cuts (default: 1)