Scene Unique Nodes

Introduction

There are times in a project where a node needs to be called from a script. However, its position in the tree might change over time as adjustments are made to a scene, such as a button in a UI scene.

In situations like this, a node can be turned into a scene unique node to avoid having to update a script every time its path is changed.

Creating and using them

In the Scene tree dock, right-click on a node and select Access as Scene Unique Name in the context menu.

../../_images/unique_name.png

After checking this, the node will now have a percent symbol (%) next to its name in the scene tree:

../../_images/percent.png

To use a unique node in a script, use the % symbol and the node’s name in the path for get_node(). For example:

GDScript

  1. get_node("%RedButton").text = "Hello"