hollow_solids
Hollows solid VMF brushes into room walls with mitred corners, preserves face materials, and verifies exact wall volume before writing to prevent invalid geometry.
Instructions
Turns solid blocks into the walls of a room. Hammer has this and Hammer's version overlaps at the corners: each wall spans its whole face, so two adjacent walls both occupy the corner between them. This one mitres, because 'this point is nearer face i than face j' turns out to be a plane, so each wall stays a single convex brush and no two share a cubic unit. The check is exact: the walls must sum to the outer volume less the room inside, and the tool refuses to write if they do not. Each wall keeps the material the source brush had on that face; the inner surface and the mitres take innerMaterial, which defaults to nodraw so a hollowed block does not become a room with brick on the outside of its own walls.
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>",
"thickness": "<thickness>"
},
"name": "hollow_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. | |
| material | No | Brushes carrying this on at least one face. | |
| solidIds | No | Hammer ids of the brushes to hollow. | |
| direction | No | 'in' keeps the outer surface where it was; 'out' keeps the inner one. | in |
| thickness | Yes | Wall thickness, in Hammer units. | |
| keepSource | No | Leave the original brush in place. Default false, because a block left inside its own walls is still a solid block. | |
| innerMaterial | No | Material for the faces hollowing created. Default TOOLS/TOOLSNODRAW. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | ||
| matched | Yes | ||
| written | Yes | ||
| hollowed | Yes | ||
| nextStep | Yes | ||
| warnings | Yes | ||
| unchanged | Yes | ||
| backupPath | Yes | ||
| solidsAfter | Yes | ||
| solidsBefore | Yes |