delete_solids
Removes brushes from a .vmf by id, owner, material or bounding box, with optional backup and dry-run, so misplaced geometry can be undone instead of staying permanent.
Instructions
Removes brushes from a .vmf. The counterpart of write_vmf_solid, and its absence is what made every mistake permanent: a brush created in the wrong place could not be taken back. Selects by id, owner, material or bounding box, refuses an empty selector rather than emptying the map, and refuses brushes inside a hidden block, whose removal would be as invisible as they are. Warns when the world is left with nothing to seal with, and when a brush entity is left with no brushes at all. It cannot prove the map still seals -- only a compile can.
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": "delete_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 such as func_detail. | |
| 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. Entirely, not partly: a half-caught brush is how a box selection catches something the caller could not see it had touched. | |
| confirm | No | Required (true) to run this tool: it writes or executes. | |
| material | No | Brushes carrying this on at least one face. Substring, case-insensitive. | |
| solidIds | No | Hammer ids, as read_vmf_solids reports them. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | ||
| deleted | Yes | ||
| matched | Yes | ||
| written | Yes | ||
| nextStep | Yes | ||
| warnings | Yes | ||
| unchanged | Yes | ||
| backupPath | Yes | ||
| solidsAfter | Yes | ||
| solidsBefore | Yes | ||
| worldSolidsAfter | Yes |