ProjectBackup/Unity/Landmass Generation/Library/PackageCache/com.unity.visualscripting@1.7.6/Documentation~/vs-add-variable-graph.md

Create and add a variable to a Script Graph

You can create and add a variable to a Script Graph in one of two ways: use the Graph window's Blackboard, or add a node to a graph.

Note

You can't add a Flow variable to your graph from the Blackboard. For more information on Flow variables, see Variables.

Create and add a new variable through the Blackboard

To create a new variable in the Blackboard and add it to your graph:

1. With a graph open in the Graph window, in the Blackboard, select the scope for the variable you want to add: Graph, Object, Scene, App, or Saved. For more information on variable scopes and when you can use each scope in your graph, see Variables.

   Tip

   If the Blackboard isn't visible in the Graph window, select Blackboard () from the toolbar.

2. In the (New Variable Name) field, enter a name for your new variable, then press Enter or select the Add Variable (+) button.

3. In the Type list, select the data type for your variable. For more information on types, see Object types.

4. (Optional) In the Value field, enter or modify the default value for your variable.

5. To add the node to your graph, click and drag from the Handle (=) on the variable's definition in the Blackboard into the Graph Editor. Visual Scripting adds a new Get Variable node for your variable to your graph:

Create and add a new variable through the Graph Editor

To create a Flow variable or another new variable directly in your graph:

1. With a graph open in the Graph window, right-click inside the Graph Editor to open the Fuzzy Finder.

2. Select the Variables category, then select the scope for the variable you want to add: Flow, Graph, Object, Scene, Application, or Saved. For more information on variable scopes and when you can use each scope in your graph, see Variables.

3. Select the Set <Scope> Variable node, where <Scope> is the scope you selected in the previous step. Visual Scripting adds a new Set Variable node to your graph.

4. In the String text field, indicated by an orange dot on the node, enter a name for your new variable.

5. (Object variables only) In the GameObject field, indicated by a GameObject icon on the node, specify the GameObject where you want to create the variable. Do one of the following:

   • Select the object picker (circle icon) and select a GameObject.
   • Attach a node to the field's data input port that outputs a GameObject.
   • Leave the field as the default value of This to use the GameObject where you attached your Script Graph to a Script Machine.

6. (Optional) To set a default value for your variable, connect another node that outputs the value you want to the Set Variable node's data input port.

Next steps

Once you've added a variable to your graph, you can add nodes to your Script Graph, create node groups, or add a Subgraph.