12345678910111213141516171819202122232425262728293031323334353637 |
- .. _doc_scene_unique_nodes:
- 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.
- .. image:: img/unique_name.png
- After checking this, the node will now have a percent symbol (**%**) next
- to its name in the scene tree:
- .. image:: img/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:
- .. tabs::
- .. code-tab:: gdscript GDScript
- get_node("%RedButton").text = "Hello"
|