paint_displacement
Paints displacement blend channels uniformly, by height, or by slope so blend materials display textures correctly; warns when a material has no blend shader.
Instructions
Paints the blend channel of displacements: uniform, by height, or by slope. A blend material draws its second texture where alpha is 255 and its first where it is zero, which is how a gravel path appears through grass. By height fades between two elevations rather than stepping, because a shoreline that changes in one vertex is not what anyone wants. Says so when the material has no blend in its name: alpha does nothing on a material that is not a blend shader, and vbsp does not mention it.
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>",
"rule": "<rule>"
},
"name": "paint_displacement"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Path to the .vmf, absolute or relative to the repo root. | |
| rule | Yes | ||
| 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. | |
| solidIds | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | ||
| written | Yes | ||
| maxAlpha | Yes | ||
| minAlpha | Yes | ||
| nextStep | Yes | ||
| warnings | Yes | ||
| unchanged | Yes | ||
| backupPath | Yes | ||
| verticesPainted | Yes |