group_solids
Group or ungroup brushes in a VMF so Hammer treats members as one selectable unit while each solid keeps only one group ID.
Instructions
Puts brushes in one Hammer group, or takes them out of theirs. A group has no name: Hammer treats its members as one thing when you click any of them, and that is all it is. A solid carries exactly one group id, so grouping a brush that is already grouped moves it rather than adding a second id, which Hammer would read as whichever came first. read_map_organisation reads it back -- groups, and solidsInNoGroup. (The Python sidecar cannot: its writer emits 'groupid' and its parser looks for 'group', so anything going through it reports no group membership on any map. That is a caveat about the sidecar's own map reading, not about verifying this.)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>"
},
"name": "group_solids"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Path to the .vmf, absolute or relative to the repo root. | |
| owner | No | 'world', or a brush entity classname. | |
| backup | No | Copy the file to <file>.bak before writing. Nothing is copied on a no-op. | |
| dryRun | No | Check and report without writing. Every verification runs either way. | |
| within | No | ||
| confirm | No | Required (true) to run this tool: it writes or executes. | |
| ungroup | No | Take the brushes out of their group instead. | |
| material | No | Brushes carrying this on at least one face. | |
| solidIds | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | ||
| groupId | Yes | ||
| written | Yes | ||
| nextStep | Yes | ||
| warnings | Yes | ||
| unchanged | Yes | ||
| backupPath | Yes | ||
| solidsChanged | Yes |