read_lightmap_budget
Reads a compiled BSP to report total lightmap luxel count, face-size histogram, costliest faces, and luxels per lit surface unit, excluding sky, nodraw, and no-light faces so the total reflects real budget.
Instructions
Where a compiled map's lightmap resolution went. Reads FACES and TEXINFO by offset: the total luxel count, a histogram by face size, the costliest individual faces, and luxels per unit of lit surface area when computable. Faces that could never carry a lightmap -- sky, nodraw, SURF_NOLIGHT -- are excluded via TEXINFO's flags, so the total is a budget, not a headcount padded with faces that cost nothing.
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_lightmap_budget"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Path to the .bsp, absolute or relative to the repo root. | |
| limit | No | How many of the costliest faces to list. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | ||
| costliest | Yes | ||
| faceCount | Yes | ||
| totalLuxels | Yes | ||
| distribution | Yes | ||
| facesWithLightmap | Yes | ||
| luxelsPerAreaUnit | Yes | totalLuxels / summed face area, in Hammer units^2. Null when no lit face has area. |