read_vmf_nearest_surface
Finds the nearest solid surface to a point in a .vmf, returning the exact distance, closest point, and owning brush and face for clearance and trace checks.
Instructions
The nearest solid surface to a point in a .vmf, exactly -- distance, the point on the surface, and which brush and face it belongs to. Exact rather than sampled: the closest point on a convex brush is the closest over its faces, and on a face it is either the foot of the perpendicular or a point on an edge. A sampled version would report a clearance that changes when the sample step does.
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": "read_vmf_nearest_surface"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | Yes | A point in Hammer units, [x, y, z]. | |
| mask | No | What counts as an obstacle. `sight` sees through clip brushes, `player` does not, `solid` is the world as vbsp builds it. The difference between 'can they see the door' and 'can they reach it'. | solid |
| path | Yes | ||
| owners | No | ||
| radius | No | How far to look. Nothing within it reports null rather than the nearest anyway. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | ||
| notes | Yes | ||
| radius | Yes | ||
| nearest | Yes | ||
| excluded | Yes | ||
| brushCount | Yes | ||
| insideSolid | Yes |