measure_vmf_clearance
Measures actual free width and headroom at a point in a .vmf using a swept player hull, finding the narrowest direction and naming the brush that limits each clearance.
Instructions
How much room there actually is at a point in a .vmf: the free width across, the headroom, and what stops each measurement. Measured with a swept player hull rather than a ray, because that is the question -- a line passes a 24-unit gap that nobody fits through, and reports it as clear. The narrowest direction is found rather than assumed, since a corridor is wide one way and long the other, and a diagonal alley is narrow diagonally. Every number names the brush that bounded it.
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>",
"at": "<at>"
},
"name": "measure_vmf_clearance"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | Yes | Where to measure, in Hammer units. | |
| axis | No | Measure across this direction only. Omit to search for the narrowest. | |
| hull | No | Source's own player hulls: 32x32x72 standing, 32x32x36 crouching. | standing |
| mask | No | `player` counts clip brushes, which are invisible and stop people. | player |
| path | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | Yes | ||
| hull | Yes | ||
| path | Yes | ||
| notes | Yes | ||
| floorZ | Yes | ||
| hullFits | Yes | ||
| boundedBy | Yes | ||
| standingAt | Yes | ||
| widthUnits | Yes | ||
| insideSolid | Yes | ||
| widthMetres | Yes | ||
| headroomUnits | Yes | ||
| narrowestAxis | Yes | ||
| ceilingBrushId | Yes | ||
| headroomMetres | Yes | ||
| headroomUnbounded | Yes |