playtest-unity/playtest/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.