if

This block is part of the value group and was last modified in core v10.4.28.

if v10.4.28

Conditional branching for values (if.. then.. else..). Selects which input value is passed through; it does not route flow.

In pins 3
  • true required
    value
  • false required
    value
  • boolean required
    condition
Out pins 1
  • value
    value

VALUE selector, not a flow gate: the engine pre-evaluates condition and this block outputs the input wired to the winning pin (then when true, else when false). It does not route execution and works for any value type, not just arrays. When no branch was pre-chosen it outputs an empty string.

branch

if outputs its then value when the condition pin is true and its else value otherwise, the value-level cousin of branch. The condition comes from == here, and the result lands in a custom text element.

Studio canvas example for the if block: picking a value by condition.

Commonly used with

In production blueprints, this block is most often wired together with:

  • value: feeds into this block. Simply returns the provided value.
  • if: wired in both directions with this block. Conditional branching for values (if.. then.. else..). Selects which input value is passed through; it does not route flow.
  • new object: this block feeds into it. Builds a new object filled with the given fields.
  • create: feeds into this block. Creates a new function that can be executed using the given name.
  • ==: feeds into this block. returns true if the two values are equal.
  • get fields: feeds into this block. Gets the selected fields from the given object.

Version history

Introduced in v10.4.28.


Back to value Return to the main group to view all sub-groups Back to conditions Return to the group to view all blocks within this group