read_map_dependencies
Resolve every asset a compiled map references and where each comes from at runtime — packed in the BSP, found in game content, or missing — by walking VMT patches, model materials, and skybox sides.
Instructions
Every asset a compiled map references, and where each will come from at runtime: packed inside the map, found in the game's own content, or missing. Missing is the purple checkerboard -- the only failure on this list a mapper never sees at home, because they have the files. The walk is recursive on purpose: it follows VMT patch and include chains, $bottommaterial and $fallbackmaterial, a model's own material list, the skybox's six sides and the detail sprite config. Resolving one level gives a short, plausible, wrong answer. Also separates what is packed but never reached into three groups, because 'unreferenced' is not 'safe to delete': vrad's own output (.vhv, cubemaps) is referenced by the engine and named by no file. Needs the Python sidecar; see health.
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_map_dependencies"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| game | No | Game profile id. This fork supports only 'l4d2', which is also the default; any other id is refused rather than answered about the wrong game. | |
| path | Yes | Path to the .bsp, absolute or relative to the repo root. | |
| limit | No | Maximum entries per list. Default 300. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| game | Yes | ||
| path | Yes | ||
| loose | Yes | ||
| caveat | Yes | ||
| missing | Yes | ||
| bySource | Yes | packed, game-vpk, game-loose. The last is the one that matters: a loose file resolves at home because it is on that disk and is a checkerboard elsewhere. | |
| resolved | Yes | ||
| gameError | Yes | ||
| notWalked | Yes | ||
| looseCount | Yes | ||
| modelCount | Yes | ||
| gameMounted | Yes | ||
| missingCount | Yes | ||
| materialCount | Yes | ||
| notWalkedCount | Yes | ||
| optionalAbsent | Yes | ||
| staticPropError | Yes | ||
| engineOwnedCount | Yes | ||
| missingTruncated | Yes | ||
| packedUnreferenced | Yes | ||
| staticPropModelCount | Yes | ||
| packedUnreferencedCount | Yes |