Add vertex snapping to the 3D editor by ryevdokimov · Pull Request #117235 · godotengine/godot

ryevdokimov · 2026-03-09T01:15:26Z

Closes: Add object snapping to the floor/vertices for the 3D editor viewport godot-proposals#755
Requires and Includes: Fix 3D editor overlay not redrawing on camera navigation #116910

Hold the Vertex Snap shortcut (default: B) to highlight the nearest vertex on the selected node's geometry. Click and drag to snap that vertex to vertices on other meshes. For nodes without geometry (Camera3D, Marker3D, etc.), the node's origin snaps directly to the target vertex.

2026-03-08.21-00-36.mp4

jcostello · 2026-03-09T01:54:12Z

Works with imported meshes?

ryevdokimov · 2026-03-09T02:11:04Z

Works with imported meshes?

Anything that uses TriangleMesh, imported or otherwise, which is most things with clickable and visible geometry.

fire · 2026-03-09T06:11:18Z

I worked on the ux of https://github.com/jgillich/godot-snappy and the snapper has bitrotted, but I hope it can inspire enhancements to this pull request.

passivestar · 2026-03-09T08:42:16Z

to highlight the nearest vertex on the selected node, then click and drag to snap it to vertices on other meshes

If I understand correctly this means you can only move one mesh at a time? It would be better to highlight nearest vertex on any visible mesh, then move all of the selected nodes using it as a reference point. This will allow moving multiple at once and moving non-meshes along with them.

This is how it works in blender:

blendersnapping.mp4

editor/scene/3d/node_3d_editor_plugin.cpp

ryevdokimov · 2026-03-09T13:04:45Z

This will allow moving multiple at once and moving non-meshes along with them.

Done.

2026-03-09.08-29-39.mp4

AThousandShips · 2026-03-09T13:05:01Z

editor/scene/3d/node_3d_editor_plugin.cpp

+		Vector3 source_display = vertex_snap_source;
+		if (vertex_snap_dragging) {
+			for (const KeyValue<ObjectID, Vector3> &E : vertex_snap_original_positions) {
+				Node3D *node = Object::cast_to<Node3D>(ObjectDB::get_instance(E.key));


Suggested change

Node3D *node = Object::cast_to<Node3D>(ObjectDB::get_instance(E.key));

Node3D *node = ObjectDB::get_instance<Node3D>(E.key);

AThousandShips · 2026-03-09T13:05:14Z

editor/scene/3d/node_3d_editor_plugin.cpp

+
+				if (has_displacement) {
+					for (const KeyValue<ObjectID, Vector3> &E : vertex_snap_original_positions) {
+						Node3D *node = Object::cast_to<Node3D>(ObjectDB::get_instance(E.key));


Suggested change

Node3D *node = Object::cast_to<Node3D>(ObjectDB::get_instance(E.key));

Node3D *node = ObjectDB::get_instance<Node3D>(E.key);

AThousandShips · 2026-03-09T13:05:34Z

editor/scene/3d/node_3d_editor_plugin.cpp

+	vertex_snap_has_target = false;
+
+	for (const KeyValue<ObjectID, Vector3> &E : vertex_snap_original_positions) {
+		Node3D *node = Object::cast_to<Node3D>(ObjectDB::get_instance(E.key));


Suggested change

Node3D *node = Object::cast_to<Node3D>(ObjectDB::get_instance(E.key));

Node3D *node = ObjectDB::get_instance<Node3D>(E.key);

AThousandShips · 2026-03-09T13:05:44Z

editor/scene/3d/node_3d_editor_plugin.cpp

+	EditorUndoRedoManager *undo_redo = EditorUndoRedoManager::get_singleton();
+	undo_redo->create_action(TTR("Vertex Snap"));
+	for (const KeyValue<ObjectID, Vector3> &E : original_positions) {
+		Node3D *node = Object::cast_to<Node3D>(ObjectDB::get_instance(E.key));


Suggested change

Node3D *node = Object::cast_to<Node3D>(ObjectDB::get_instance(E.key));

Node3D *node = ObjectDB::get_instance<Node3D>(E.key);

AThousandShips · 2026-03-09T13:05:54Z

editor/scene/3d/node_3d_editor_plugin.cpp

+
+void Node3DEditorViewport::_vertex_snap_commit() {
+	for (const KeyValue<ObjectID, Vector3> &E : vertex_snap_original_positions) {
+		Node3D *node = Object::cast_to<Node3D>(ObjectDB::get_instance(E.key));


Suggested change

Node3D *node = Object::cast_to<Node3D>(ObjectDB::get_instance(E.key));

Node3D *node = ObjectDB::get_instance<Node3D>(E.key);

Calinou

Tested locally with a mix of CSG nodes, MeshInstance3Ds, Decals and Marker3Ds, it works as expected.

Some feedback:

It's possible to enable vertex snapping while dragging gizmos or using Blender-style manipulation shortcuts. However, it has no visible effect other than drawing the yellow circle gizmo around a vertex.
It should be possible to release B after starting a dragging operation, so you don't have to keep it held down the whole way. Right now, releasing B while dragging will stop moving the selected node (but won't cancel the operation).
The vertex snap gizmo could be drawn twice (once opaque with normal depth, once translucent with depth test disabled), so that you can be aware that you're snapping to a vertex that is occluded by another object:

Current	Proposed (mockup)

We use the same trick for the 3D selection box, so it appears translucent when occluded.

Non-geometry nodes like Decal, ReflectionProbe and Marker3D behave a bit oddly. You can enable vertex snapping and move the node according to the snapped vertex, but the node won't center around the vertex like one would probably expect. Instead, it will move relative to your mouse movement, taking the snapped vertex into account.
- I can't think of a lot of use cases for this, so I think it would make more sense to move the node's origin to the snapped vertex instead. This makes sense for Marker3D nodes in particular, which may be used as "shot origins" on weapon models, characters, etc.
Out of curiosity, is edge/face snapping planned in the future?

ryevdokimov · 2026-03-10T01:51:31Z

Feedback applied:

2026-03-09.21-37-52.mp4

Out of curiosity, is edge/face snapping planned in the future?

Yes, I do intend to provide, to the best of my ability, all the tools and features someone would expect from a 3D editor. 🙂

Fix 3D editor overlay not redrawing on camera navigation

8d92f62

ryevdokimov added this to the 4.x milestone Mar 9, 2026

ryevdokimov requested review from a team as code owners March 9, 2026 01:15

ryevdokimov added enhancement topic:editor usability topic:3d labels Mar 9, 2026

ryevdokimov requested a review from a team March 9, 2026 01:15

ryevdokimov force-pushed the vertex-snap branch from 08acf1f to 599117f Compare March 9, 2026 02:46

AThousandShips reviewed Mar 9, 2026

View reviewed changes

editor/scene/3d/node_3d_editor_plugin.cpp Outdated Show resolved Hide resolved

editor/scene/3d/node_3d_editor_plugin.cpp Outdated Show resolved Hide resolved

dujanhung approved these changes Mar 9, 2026

View reviewed changes

ryevdokimov force-pushed the vertex-snap branch from 599117f to 2079727 Compare March 9, 2026 11:12

ryevdokimov marked this pull request as draft March 9, 2026 12:24

ryevdokimov force-pushed the vertex-snap branch from 2079727 to 56536dd Compare March 9, 2026 13:04

ryevdokimov marked this pull request as ready for review March 9, 2026 13:04

AThousandShips reviewed Mar 9, 2026

View reviewed changes

ryevdokimov force-pushed the vertex-snap branch 2 times, most recently from 9437f8b to d1d0c17 Compare March 9, 2026 19:46

Calinou reviewed Mar 9, 2026

View reviewed changes

Add vertex snapping to the 3D editor

6af41be

ryevdokimov force-pushed the vertex-snap branch from d1d0c17 to 6af41be Compare March 10, 2026 01:45

	Node3D *node = Object::cast_to<Node3D>(ObjectDB::get_instance(E.key));
	Node3D *node = ObjectDB::get_instance<Node3D>(E.key);

Uh oh!

Conversation

ryevdokimov commented Mar 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

jcostello commented Mar 9, 2026

Uh oh!

ryevdokimov commented Mar 9, 2026

Uh oh!

fire commented Mar 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

passivestar commented Mar 9, 2026

Uh oh!

Uh oh!

Uh oh!

ryevdokimov commented Mar 9, 2026

Uh oh!

AThousandShips Mar 9, 2026

Choose a reason for hiding this comment

Uh oh!

AThousandShips Mar 9, 2026

Choose a reason for hiding this comment

Uh oh!

AThousandShips Mar 9, 2026

Choose a reason for hiding this comment

Uh oh!

AThousandShips Mar 9, 2026

Choose a reason for hiding this comment

Uh oh!

AThousandShips Mar 9, 2026

Choose a reason for hiding this comment

Uh oh!

Calinou left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

ryevdokimov commented Mar 10, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

7 participants

ryevdokimov commented Mar 9, 2026 •

edited

Loading

fire commented Mar 9, 2026 •

edited

Loading

Calinou left a comment •

edited

Loading