move_plane
Move every vertex on one axis-aligned plane of a SketchUp Make 2017 group to resize a room or shift a wall, with guards and dry-run previews.
Instructions
Move every vertex lying on one axis-aligned plane of a group, by (to - from). This is the wall-move / room-resize operation. Takes exactly one undo step, aborts without changing anything if any face would end up non-planar, deletes edges the move stranded, and reports before/after counts (faces, edges, open edges, near-coincident vertices) so the result can be checked with audit_geometry. Refuses a move that would shift only some of a face's corners lying on that plane — which tilts the face without splitting it or making it non-planar — or that would change a face from vertical/horizontal. Reaches into nested groups inside the target group. Refuses by default if the vertices would span more than one collection — name them in 'include' or drop them with 'exclude'. Use dry_run:true to see what would change without changing it. All lengths and coordinates are in metres.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Target plane coordinate, in metres | |
| axis | Yes | Which plane orientation to move | |
| from | Yes | Current plane coordinate, in metres | |
| group | Yes | Group to edit. Found at any nesting depth: a top-level group with this name wins, otherwise the name must be unique in the model (an ambiguous name is refused, listing the matches). | |
| dry_run | No | Report what would change, change nothing (default false) | |
| exclude | No | Skip vertices in these collections, e.g. a door frame that happens to sit in the wall plane. | |
| include | No | Only move vertices in these collections (a group name, or a full path like 'Basement/Garden door - frame'). Also how you acknowledge a deliberate move spanning more than one collection. | |
| x_range | No | Only move vertices whose X is within [min, max] | |
| y_range | No | Only move vertices whose Y is within [min, max] | |
| z_range | No | Only move vertices whose Z is within [min, max] | |
| tolerance | No | How close a vertex must be to 'from' to count as on the plane (default 1.5 mm) | |
| allow_splits | No | Permit the edit even if it splits faces. Off by default: a split means only part of a face moved and the geometry got folded. | |
| allow_distortion | No | Permit the edit even if it tilts a face (only some of its on-plane corners move) or changes a face from vertical/horizontal. Off by default. |