write_vmf_fitting
Build door casings, counters, skirting and cornices as articulated multi-brush assemblies from a mins/maxs envelope, preventing flat single-slab fittings.
Instructions
Builds the things a room is finished with -- a door casing, a counter, skirting or a cornice -- as the several brushes each of them actually is. write_vmf_solid makes one convex shape per call, so an agent that thinks 'counter' writes a box: three rounds of building maps with these tools produced counters, shelving and doorways that were each a single slab, with a door texture painted flat on a wall where a frame should be. The trade here is that you own the envelope and this owns the articulation -- give it the same mins/maxs you would have given a box and get a worktop with a nosing over a body over a recessed kick. Every internal dimension comes from a table measured off models Valve ships (read_model_info, 13/08/2026), which also found that Source's world is built a third taller than its own player: a door leaf is 108 units, a shop counter 56, with the eye at 64. Refuses any assembly whose parts share an interior or fail to join up, which is a class of error per-brush validation cannot see.
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>",
"fittings": "<fittings>"
},
"name": "write_vmf_fitting"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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. | |
| confirm | No | Required (true) to run this tool: it writes or executes. | |
| entityId | No | Hammer id of a brush entity to add them to. Omit to add them to the world. | |
| fittings | Yes | What to build, in order. | |
| material | No | Material for every face. Default TOOLS/TOOLSNODRAW. | |
| materials | No | Material per role, as write_vmf_solid takes it and at the same threshold. | |
| textureScale | No | Texture scale on both axes. Default 0.25. | |
| lightmapScale | No | Luxels per unit on every face. Default 16. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | ||
| built | Yes | ||
| notes | Yes | ||
| target | Yes | ||
| written | Yes | ||
| solidIds | Yes | ||
| verified | Yes | ||
| warnings | Yes | ||
| backupPath | Yes | ||
| bytesAdded | Yes | ||
| solidsAfter | Yes | ||
| solidsBefore | Yes |