set_solid_class
Moves brushes into or out of func_detail to keep trim, pillars and window frames from splitting the BSP tree, cutting compile time and improving the PVS. It does not seal the map.
Instructions
Moves brushes between the world and a brush entity -- in practice, into or out of func_detail. This is the largest single lever on a Source map's performance and it is invisible in a compiled .bsp, because vbsp folds func_detail into the world: a shipped map cannot tell you which brushes were structural. A structural brush splits the BSP tree and spawns visleaves, so trim, pillars and window frames cost a slower compile and a worse PVS for nothing. WARNING: a func_detail brush does not seal the map. Move a wall into one and the next compile leaks, and no check here can rule that out -- sealing is a property of the whole hull. Compile afterwards and read the leak.
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>",
"solidIds": "<solidIds>",
"to": "<to>"
},
"name": "set_solid_class"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | 'world' to make them structural again, or a brush entity classname such as func_detail, func_illusionary, func_brush. | |
| path | Yes | Path to the .vmf, absolute or relative to the repo root. | |
| backup | No | Copy the file to <file>.bak before writing. Nothing is copied on a no-op. | |
| dryRun | No | Check and report without writing. Every verification runs either way. | |
| confirm | No | Required (true) to run this tool: it writes or executes. | |
| entityId | No | Existing entity of that class to add to. Omit to create one. Grouping is taste, not performance: vbsp dissolves every func_detail into the world regardless. | |
| solidIds | Yes | Hammer ids of the solids to move. read_vmf_solids lists them. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | ||
| moved | Yes | ||
| written | Yes | ||
| nextStep | Yes | ||
| warnings | Yes | ||
| unchanged | Yes | ||
| backupPath | Yes | ||
| createdEntityId | Yes | ||
| worldSolidsAfter | Yes |