run_compile
Compiles a .vmf natively with vbsp, vvis, and vrad, returns per-stage findings, and stops at the first failure to catch leaks before wasted compile time.
Instructions
Compiles a .vmf with vbsp, vvis and vrad natively, and returns each stage's findings rather than its raw output. Takes minutes to hours: vvis on a large map is the slow part, and -fast exists for iteration. Stops at the first stage that fails, because vvis and vrad results are meaningless after a leak. Run read_vmf_lint first -- it catches before the compile most of what makes one fail.
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": {
"vmf": "<vmf>"
},
"name": "run_compile"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hdr | No | vrad -both, for an HDR and an LDR lightmap set. | |
| vmf | Yes | Path to the .vmf, absolute or relative to the repo root. | |
| cull | No | Hammer++ only, and ON by default whenever the ++ chain runs. Culls unreferenced planes, vertices, brushes and brush sides even when no limit is reached yet. Measured on ttt_traps: -20.5% PLANES, -12.8% VERTEXES, -10.5% file size, with FACES and TEXINFO unchanged -- which is what distinguishes a prune from a broken map. Pass false to compile without it; read_map_geometry before and after is the check. Passing true with toolchain 'stock' is refused rather than ignored. | |
| fast | No | vvis -fast and vrad -fast: minutes instead of hours, dev quality only. | |
| 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. | |
| stages | No | Stages to run, in order. vbsp alone is enough to check a map seals. | |
| confirm | No | ||
| toolchain | No | Which compilers to drive. The default 'plusplus' is ficool2's Hammer++ rebuild: much faster vvis and flags the stock chain does not have. Falls back to 'stock' when it is not installed, and the result says which one ran. 'stock' forces the compilers that ship with the game, which is what a comparison between the two needs. | plusplus |
| timeoutMinutes | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| bsp | Yes | ||
| vmf | Yes | ||
| cull | Yes | ||
| game | Yes | ||
| leaked | Yes | ||
| stages | Yes | ||
| bspBytes | Yes | ||
| bspExists | Yes | ||
| pointfile | Yes | ||
| toolchain | Yes | ||
| toolchainNote | Yes | ||
| toolchainRequested | Yes |