move_vertices
Move named brush corners in a VMF to shape convex geometry, rejecting any move that would leave a face non-planar, matching Hammer's vertex editor.
Instructions
Moves named corners of one brush: Hammer's vertex manipulation tool. The last thing between an assembly of cut boxes and an arbitrary convex shape -- it is what pulls a wall out to meet a street that does not run square. Corners are named by position, as read_vmf_solids reports them. It refuses far more than it accepts, and that is parity with the editor rather than a shortfall: moving one corner moves it on every face that shares it, three of them on a box, so a diagonal pull leaves each of those faces with a point off its own plane. Hammer shows that as a red invalid solid and will not build it either. Moves that work are the ones keeping every face flat: a whole edge, or a whole face. Texture axes are left alone, as Hammer leaves them.
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>",
"solidId": "<solidId>",
"moves": "<moves>"
},
"name": "move_vertices"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | Path to the .vmf, absolute or relative to the repo root. | |
| moves | Yes | Corners to move, each named by where it is now. | |
| 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. | |
| solidId | Yes | Hammer id of the brush. read_vmf_solids lists the corners. | |
| tolerance | No | How close a coordinate must be to a real corner to name it. Default 0.5, because corners read back through JSON are rounded and exact equality would make the tool unusable from outside. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | Yes | ||
| moved | Yes | ||
| solidId | Yes | ||
| written | Yes | ||
| nextStep | Yes | ||
| warnings | Yes | ||
| maxsAfter | Yes | ||
| minsAfter | Yes | ||
| unchanged | Yes | ||
| backupPath | Yes | ||
| volumeAfter | Yes | ||
| volumeBefore | Yes | ||
| planarityError | Yes |