set_smoothing_groups
Assign Hammer smoothing groups (1–32) to selected VMF faces so shared edges light as continuous surfaces; converts group numbers to bitmasks and can clear groups.
Instructions
Sets the smoothing groups on selected faces. Two faces sharing an edge and a group are lit by vrad as one continuous surface; without it every facet of a curve is lit separately and reads as the flat polygons it really is. Takes Hammer's own group numbers, 1 to 32, and does the bit shifting -- the file stores a bitmask, so group 13 is 4096 and getting that wrong is silent. Pass an empty list to clear them.
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>",
"groups": "<groups>"
},
"name": "set_smoothing_groups"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| all | No | Every face of the map. Required when no other criterion is given. | |
| path | Yes | Path to the .vmf, absolute or relative to the repo root. | |
| 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. | |
| facing | No | Only faces pointing this way. 'up' is a floor, 'down' a ceiling, 'side' a wall; the cut is at 45 degrees, so a ramp counts as what it is closer to being. | |
| groups | Yes | Hammer's group numbers, 1 to 32. Empty clears every group. | |
| confirm | No | Required (true) to run this tool: it writes or executes. | |
| minArea | No | Only faces at least this large, in square units. | |
| material | No | Only faces already carrying this. Substring, case-insensitive. | |
| solidIds | No | Only faces of these solids. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mask | Yes | ||
| path | Yes | ||
| matched | Yes | ||
| written | Yes | ||
| nextStep | Yes | ||
| warnings | Yes | ||
| unchanged | Yes | ||
| backupPath | Yes | ||
| facesChanged | Yes |