clip_solids
Cuts VMF brushes with a plane, keeping the front, back, or both halves while preserving surviving face materials, texture axes, lightmap scale, and smoothing groups.
Instructions
Cuts brushes with a plane, keeping the front, the back, or both. This is Hammer's clip tool, the most-used one in the editor and the one that unlocks every shape that is not an assembly of boxes. A face that survives keeps its own material, texture axes, lightmap scale and smoothing groups -- the side block is copied, not rebuilt. A face that no longer bounds anything is dropped rather than left redundant. The new face gets its axes from vbsp's base-axis table and inherits the material of the largest face kept, which is what Hammer does. Keeping both halves is the check: their volumes must sum to the original, and the tool refuses to write if they do not.
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>",
"plane": "<plane>",
"keep": "<keep>"
},
"name": "clip_solids"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keep | Yes | 'front' is the side the normal points towards. 'both' leaves two brushes. | |
| path | Yes | Path to the .vmf, absolute or relative to the repo root. | |
| owner | No | 'world', or a brush entity classname. | |
| plane | Yes | The cutting plane, as a point and a normal or as three points. | |
| 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 | Brushes lying entirely inside this box. | |
| confirm | No | Required (true) to run this tool: it writes or executes. | |
| material | No | Brushes carrying this on at least one face. | |
| solidIds | No | Hammer ids of the brushes to cut. | |
| cutMaterial | No | Material for the new face. Default: the material of the largest face kept. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | ||
| solids | Yes | ||
| matched | Yes | ||
| written | Yes | ||
| nextStep | Yes | ||
| warnings | Yes | ||
| unchanged | Yes | ||
| backupPath | Yes | ||
| solidsAfter | Yes | ||
| solidsBefore | Yes |