sculpt_displacement
Reshape terrain displacements by flattening, raising, sloping between heights, or adding seeded noise; check if shared edges opened a seam and repair it.
Instructions
Reshapes displacements: flatten, raise, slope between two heights, or add noise. Declarative shapes rather than a table of vertices, and noise takes a seed rather than reaching for a random number generator -- a terrain that cannot be regenerated from what produced it cannot be reviewed, cannot be tested and cannot survive a merge. Sculpting one displacement of a terrain moves the edge it shares with its neighbours, so the result says whether a seam opened and sew_displacements closes 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>",
"shape": "<shape>"
},
"name": "sculpt_displacement"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Path to the .vmf, absolute or relative to the repo root. | |
| shape | 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 | Displacements on these brushes. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | ||
| written | Yes | ||
| nextStep | Yes | ||
| warnings | Yes | ||
| unchanged | Yes | ||
| backupPath | Yes | ||
| seamsAfter | Yes | ||
| maxDistance | Yes | ||
| minDistance | Yes | ||
| verticesMoved | Yes |