Add Replace to SceneTree context menu

[DexterFstone]

closes godotengine/godot-proposals#13616

2025-11-20.17-26-57.mp4

[AdriaandeJongh]

The paste options are getting increasingly confusing by adding another option. Not sure if it should be part of this PR but I can imagine that the three paste options should become something like as follows:

• Paste (as Child)
• Paste as Sibling
• Paste as Replacement

[KoBeWi]

I tested this new option. The "pasted" node keeps all properties from the replaced node, and pasting a scene makes it lose instancing. What makes this different from simply changing the type?

[DexterFstone]

I tested this new option. The "pasted" node keeps all properties from the replaced node, and pasting a scene makes it lose instancing.

Fixed
Tests:

• OLD IS NODE && NEW IS NODE
• OLD IS NODE && NEW IS SCENE
• OLD IS SCENE && NEW IS NODE
• OLD IS SCENE && NEW IS SCENE

[KoBeWi]

Rebase your branch.

[DexterFstone]

Rebase your branch.

It was, but it seems there is a connection issue, and it was not completed correctly.
VS doesn't show me any errors

[DexterFstone]

I notice that this PR can resolve godotengine/godot-proposals#4991 and godotengine/godot-proposals#12284
If you onenning target scene and copying the root node, you can replace it with a node

[KoBeWi]

The functionality is fine overall, but some of the details are disputable. Like, should the properties be preserved? Or at least the position? When replacing with a branch (i.e. node with children), should the children also be pasted? What if pasting multiple nodes? Currently it only uses the first one in the clipboard.

Though the only problematic part is how this new operation handles child nodes. It's actually bugged for non-scene children, but that's an already-existing bug: #116281 It would be nice to resolve it properly, to avoid manually adding/removing nodes.

[DexterFstone]

should the properties be preserved? Or at least the position?

Now the position will remain the same

When replacing with a branch (i.e. node with children), should the children also be pasted?

Well, the main use case of paste as a replacement is for the Packed Scenes; other than that, if the user wants the children, copy and paste can be used

[DexterFstone]

What if pasting multiple nodes? Currently it only uses the first one in the clipboard.

You mean when the number of selectend node is equal to the number of clipboard nodes?

[KoBeWi]

Some minor details left, but seems mostly fine now.

[Repiteo]

Thanks!