Construction Stage Wizard — structure groups
stage_groupsUse to make structure groups by position (slices, segments) for staging. For groups by section or material use auto_structure_groups. Creates structure groups with the Construction Stage Wizard plugin's group builder: pick a scope of elements, split it by rules (slice along X/Y/Z into n segments or at cuts, by section, material, element type, thickness, id ranges, existing groups), name them from a template, and resolve clashes with existing groups by policy. Typical use: segments of a deck for staged construction, e.g. rules [{kind:'slice', axis:'X', mode:'count', count:8, cuts:[]}] with naming {template:'Seg_{SLICE}'}. Previews unless apply: true; the write keeps a snapshot for stages_undo.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "stage_groups"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| apply | No | Write to CIVIL NX. Only after the user approved the preview. | |
| rules | No | Applied together (every combination becomes a group): {kind:'slice', axis:'X'|'Y'|'Z', mode:'count'|'cuts', count, cuts:[coords]}, {kind:'section'}, {kind:'material'}, {kind:'type'}, {kind:'thickness'}, {kind:'idRange', ranges:[{label, text}]}, {kind:'existingGroup', groups:[names]}. | |
| scope | No | {kind:'all'} | {kind:'groups', groups:[names]} | {kind:'ids', text:'1-80'} | {kind:'selection', elements:[ids]} | |
| naming | No | template with tokens {INDEX}, {SLICE}, {SECTION}, {MATERIAL}, {TYPE}…; prefix, suffix, pad, start. | |
| policy | No | What to do when a group name already exists. | skip |
| typeFilter | No | Element types to keep (BEAM, TRUSS, PLATE, SOLID…); empty = all. | |
| includeNodes | No | ||
| confirmPlanHash | No | planHash from the approved preview; the write is refused if the plan differs. |