write_hint_brush
Creates a hint brush that marks a slab’s cutting plane with TOOLS/TOOLSHINT and other faces with TOOLS/TOOLSSKIP to shape a map’s visibility tree in source VMF.
Instructions
Creates a hint brush: a slab carrying TOOLS/TOOLSHINT on the plane vvis should cut along and TOOLS/TOOLSSKIP everywhere else. This is the one lever that shapes a map's visibility tree directly, and nothing in a compiled .bsp records it -- vvis consumes hints and they are gone from the file, so this can only be done on the source. rotateZ makes the cut diagonal, which is what a mapper does when a city's streets do not run along the axes. Verify by compiling before and after and comparing read_visleaf_stats: a hint that moves no leaf count did 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>",
"mins": "<mins>",
"maxs": "<maxs>"
},
"name": "write_hint_brush"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| maxs | Yes | Upper corner of the slab, before any rotation. | |
| mins | Yes | Lower corner of the slab, before any rotation. | |
| 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. | |
| rotateZ | No | Degrees to turn the slab about its own centre. 45 gives a diagonal cut. Corners are rounded to whole units, so the faces stay exactly planar. | |
| hintFaces | No | Which faces carry the hint. 'largest' (default) hints the two biggest opposing faces, which for a thin slab is the plane you meant. 'all' hints every face. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| grid | Yes | ||
| maxs | Yes | ||
| mins | Yes | ||
| path | Yes | ||
| valid | Yes | ||
| volume | Yes | ||
| solidId | Yes | ||
| written | Yes | ||
| nextStep | Yes | ||
| warnings | Yes | ||
| backupPath | Yes | ||
| hintFaceCount | Yes | ||
| skipFaceCount | Yes |