User Guide (Version 1.17)

Pins and Connections

Connections define the cause and effect from one node to the next. Some connections determine the order of execution while others pass data from one node to the next.

Making Connections

You can make connections only between pins of the same type. For example, logic connections can only be made between logic pins, and data pins can only be made between data pins of the same type. You can't create connections between incompatible pins, such as a logic and a data pin.

To make a connection

  1. In the Script Canvas editor canvas, drag from the input pin of one node to an output pin of another node. This creates a connection line between the two pins.

  2. To move a connection from one pin to another, drag the end of a line from one pin and drop it on another pin.

    To delete a connection, right-click and choose Delete. You can also hold Alt and then click the connection to delete it.

Pin and Connection Types

Lumberyard has two main pin and connection types:

Logic pins and connections

Logic connections determine the order of execution. A Script Canvas script runs when the entity that is attached to the script is activated. Nodes are connected from the left side. After they finish running, they activate nodes that are connected to the right side of their logic flow.

An outgoing logic pin with multiple connections executes a logic branch in sequence. The execution sequence is determined by the order the connections were made, from earliest to newest. If a specific execution order is required, we recommend that you specify the sequence order through a single logic flow.

An incoming logic pin with multiple connections runs each time that the logic flow triggers the node. If a node is triggered by three different nodes in a script, the node runs three times.

Data pins and connections

Data connections enable scripts to read and write data between nodes. Data is read from the right side of one node and then set on the left side of another node.