Skip to content

Control actions

11 actions in the Control category. Each block mirrors how the action appears in the editor's sidebar.

Fill Text

Start
Fill Text Control
Target not set | Template '{0}' | Value 1 '' | Value 2 '' | Value 3 '' | Value 4 ''

Sets a Control text from a template, replacing {0}, {1} and so on with the value slots. This is the HUD label without joining strings by hand.

Input Type Default Description
Target Control - The node to write text to, such as a Label or Button. Leave it empty to write to this node.
Template String '{0}' The text, with {0}, {1}, {2}, {3} where the value slots go.
Value 1 Variant '' Fills {0} in the template.
Value 2 Variant '' Fills {1} in the template.
Value 3 Variant '' Fills {2} in the template.
Value 4 Variant '' Fills {3} in the template.

Phases StartEvery FramePhysicsEnd

Focus Control

Start
Focus Control Control
not set

Moves keyboard and gamepad focus to a Control node, such as a Button or a LineEdit. Use it to guide input to the right field.

Input Type Default Description
Target Control - The node to give keyboard focus to. Leave it empty to focus this node.

Phases StartEvery FramePhysicsEnd

Get Text

Every Frame
Get Text Control
not set

Reads the text of a Control node such as a LineEdit or Label and stores it. Use it to pick up what was typed into a field.

Input Type Default Description
Target Control - The node to read the text from. Leave it empty to read this node.
Output Type Description
Text String Where to store the text read from the node.

Phases StartEvery FramePhysicsEnd

Set Control Value

Start
Set Control Value Control
Target not set | Value 0.0

Sets the value of a Range node such as a ProgressBar, Slider or SpinBox.

Input Type Default Description
Target Range - The slider or bar to change. Leave it empty to change this node.
Value float 0.0 The value to set, within the node min and max.

Phases StartEvery FramePhysicsEnd

Set Disabled

Start
Set Disabled Control
Target not set | Disabled true

Enables or disables a Control node such as a Button or Slider.

Input Type Default Description
Target BaseButton - The button to enable or disable. Leave it empty to change this node.
Disabled bool true True to disable the node, false to enable it.

Phases StartEvery FramePhysicsEnd

Set Image

Start
Set Image Control
Target not set | Texture not set

Swaps the image shown by a node such as a TextureRect or a TextureButton. Bind Texture to an image loaded into a variable.

Input Type Default Description
Target Control - The node to change the image of. Leave it empty to change this node.
Texture Texture2D - The image to show, bound from a variable or resource.

Phases StartEvery FramePhysicsEnd

Set Placeholder

Start
Set Placeholder Control
Target not set | Text ''

Sets the hint text shown inside a LineEdit or TextEdit while it is empty.

Input Type Default Description
Target LineEdit - The text field to change. Leave it empty to change this node.
Text String '' The hint text shown while the field is empty.

Phases StartEvery FramePhysicsEnd

Set Text

Start
Set Text Control
Target not set | Text ''

Sets the text shown by a Control node such as a Label or Button.

Input Type Default Description
Target Control - The node to write text to, such as a Label or Button. Leave it empty to write to this node.
Text String '' The text to display.

Phases StartEvery FramePhysicsEnd

Set Toggled

Start
Set Toggled Control
Target not set | On true

Turns a toggle button on or off, such as a CheckBox or a CheckButton. Setting it here does not emit the toggled signal.

Input Type Default Description
Target BaseButton - The button to press or release. Leave it empty to change this node.
On bool true True to turn the button on, false to turn it off.

Phases StartEvery FramePhysicsEnd

Set Tooltip

Start
Set Tooltip Control
Target not set | Text ''

Sets the tooltip a Control node shows when the mouse rests on it.

Input Type Default Description
Target Control - The node to give the tooltip to. Leave it empty to change this node.
Text String '' The tooltip text to show on hover.

Phases StartEvery FramePhysicsEnd

Type Text

Start
Type Text Control
Label not set | Text 'Hello' | Speed 30.0 | → Finished

Reveals the text of a label one character at a time, the typewriter effect used in dialogue. Wire Finished and the flow moves on by itself when it ends, with no timer of your own. On enter it plays once; on update or physics it starts again as soon as the last one ended, so it keeps repeating while the state runs. Leaving the state before it ends reveals the rest at once, the way skipping a line of dialogue does.

Input Type Default Description
Label Control - The Label or RichTextLabel that shows the text. Leave it empty to type into this node.
Text String 'Hello' The full text to reveal.
Speed float 30.0 How many characters appear per second.
Branch Goes to
Finished Where to go when the animation ends. Leaving the state first cancels it, so it never fires late.

Phases StartEvery FramePhysics