read_vmf_trace
Trace rays or player-sized hulls through a .vmf without compiling, revealing what blocks movement or sight and which brush face is hit, so geometry can be checked before a build.
Instructions
Trace a ray, or a swept player-sized box, through a .vmf -- with no compilation. Answers what a mapper checks by walking the map: what is in the way, how far, which brush and which face. A brush is already an intersection of half-spaces, so this needs no vbsp; the same rays agree with the compiled map's own tracer to under half a unit on the probe map. Use hull: standing for anything about whether a person gets through: a line passes a 24-unit gap that nobody fits.
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>",
"from": "<from>",
"to": "<to>"
},
"name": "read_vmf_trace"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | ||
| from | Yes | A point in Hammer units, [x, y, z]. | |
| hull | No | Trace a player-sized box instead of a line. `standing` is Source's 32x32x72, `crouching` its 32x32x36. A line goes through a 24-unit gap that nobody fits. | none |
| 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 | Path to the .vmf, absolute or relative to the repo root. | |
| owners | No | Only trace against these owners, e.g. ["world", "func_detail"]. Absent means every brush in the file, including brush entities. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hit | Yes | ||
| hull | Yes | ||
| mask | Yes | ||
| path | Yes | ||
| notes | Yes | ||
| point | Yes | ||
| normal | Yes | ||
| sideId | Yes | ||
| brushId | Yes | ||
| excluded | Yes | ||
| fraction | Yes | ||
| material | Yes | ||
| brushCount | Yes | ||
| startSolid | Yes | The start was already inside a brush, so the distance means nothing. No brush is named either: a point in a wall is usually in several at once. | |
| distanceUnits | Yes | ||
| distanceMetres | Yes |