read_bsp_entities
Reads entity data from a compiled .bsp lump 0 and returns a classname histogram plus filtered, paginated entities for inspecting map contents.
Instructions
Entities of a compiled .bsp, read from lump 0. Returns a classname histogram plus a filtered, paginated entity list. Seeks straight to the lump -- on a 1 GB map this reads about 1.5 MB. Note that a compiled lump has no Hammer ids; entities are keyed by index.
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_bsp_entities"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| near | No | Centre of a radius search, as [x, y, z]. | |
| path | Yes | Path to the .bsp, absolute or relative to the repo root. | |
| limit | No | ||
| offset | No | ||
| radius | No | Radius for `near` (default 512). | |
| classname | No | Exact classname match. | |
| targetname | No | Exact targetname match. | |
| histogramOnly | No | Return only the classname histogram and counts. | |
| classnameContains | No | Substring match on classname. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | ||
| total | Yes | ||
| matched | Yes | ||
| entities | No | ||
| returned | No | ||
| histogram | Yes | ||
| lumpBytes | Yes | ||
| truncated | No | ||
| mapRevision | Yes | ||
| nulTerminated | Yes |