read_sightlines
Measure the longest unobstructed lines of sight across a compiled map to determine real engagement range. Samples standable ground on a grid and traces each pair against the engine's world tree.
Instructions
Longest unobstructed lines of sight across a compiled map, traced against the same world tree the engine walks for a TraceLine. Samples standable ground on a grid at the elevation where the map's content sits, then measures every pair. Answers 'how far can someone actually see here', which is what sets engagement range. It does NOT know what a street is, and it ignores static props and brush entities (a door counts as open) -- see the excludes field it returns.
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>"
},
"name": "read_sightlines"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Path to the .bsp, absolute or relative to the repo root. | |
| limit | No | ||
| spacing | No | Grid step in Hammer units. Smaller is finer and quadratically slower. | |
| elevation | No | Ground elevation to sample. Defaults to the median entity origin z. | |
| eyeHeight | No | Height above ground for the sample point. 64 is a standing player's eye. | |
| elevationTolerance | No | How far a surface may sit from `elevation` and still be sampled. | |
| requireNearbyContent | No | Keep only points with a map entity nearby, as a proxy for built-up area. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | ||
| longest | Yes | ||
| spacing | Yes | ||
| excludes | Yes | ||
| elevation | Yes | ||
| pairsTested | Yes | ||
| samplePoints | Yes |