Singularity/Library/PackageCache/com.unity.visualscripting@1.8.0/Documentation~/vs-create-state.md

Create a new state

You can create three types of State nodes in a State Graph: Script States, Any States, and Super States. For more information on the types of State nodes, see State Graphs in Graphs.

You can also add a Sticky Note to add comments to a graph.

Create a Script State

To create a new blank Script State:

1. [!include[open-state-menu](./snippets/vs-open-state-menu.md)]

2. Select Create Script State.
   Visual Scripting creates a new Script State node.

3. Open the Graph Inspector.

4. In the Graph Inspector, choose a source for the Script State node:

   • Embed: The graph only exists on the Script State node. You can only modify the graph from the node in its parent State Graph.

   • Graph: The graph exists in a separate file. You can modify the graph outside of its parent State Graph and reuse the graph in other areas of your application.

5. If you chose Graph:

   1. Select New.

   2. Enter a name for the graph file.

   3. Choose where you want to save the new graph.

   4. Select Save.

To create a Script State from an existing Script Graph:

1. [!include[open-state-menu](./snippets/vs-open-state-menu.md)]

2. Select Create Script State.
   Visual Scripting creates a new Script State node.

3. Open the Graph Inspector.

4. In the Graph Inspector, set the source for the Script State node to Graph.

5. Do one of the following:

   • Select the object picker (circle icon) and choose a compatible Script Graph from your project.

   • Click and drag a Script Graph file from your Project window and release on the Graph field.

Tip

Click and drag the Script Graph from your Project window into the Graph Editor to automatically create a Script State node.

Create an Any State

To create a new Any State node:

1. [!includeopen-state-menu]

2. Select Create Any State.

Create a Super State

To create a new blank Super State:

1. [!include[open-state-menu](./snippets/vs-open-state-menu.md)]

2. Select Create Super State.
   Visual Scripting creates a new Super State node.

3. Open the Graph Inspector.

4. In the Graph Inspector, choose a source for the Super State node:

   • Embed: The graph only exists on the Super State node. You can only modify the graph from the node in its parent State Graph.

   • Graph: The graph exists in a separate file. You can modify the graph outside of its parent State Graph and reuse the graph in other areas of your application.

5. If you chose Graph:

   1. Select New.

   2. Enter a name for the graph file.

   3. Choose where you want to save the new graph.

   4. Select Save.

To create a Super State from an existing State Graph:

1. [!include[open-state-menu](./snippets/vs-open-state-menu.md)]

2. Select Create Super State.
   Visual Scripting creates a new Super State node.

3. Open the Graph Inspector.

4. In the Graph Inspector, set the source for the Super State node to Graph.

5. Do one of the following:

   • Select the object picker (circle icon) and choose a compatible State Graph from your project.

   • Click and drag a State Graph file from your Project window and release on the Graph field.

Tip

Click and drag the State Graph from your Project window into the Graph Editor to automatically create a Super State node.