ProjectBackup/Unity/Landmass Generation/Library/PackageCache/com.unity.visualscripting@1.7.6/Documentation~/vs-create-state.md

Create a new state

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

Create a Script State

To create a new blank Script State:

1. With a State Graph open in the Graph window, right-click on an empty space in the Graph Editor to open the context menu. For more information on creating State Graphs, see Creating a new graph file.

2. From the context menu, select Create Script State. Visual Scripting creates a new Script State node.

3. In the Graph Inspector, choose a source for your new Script State's Script Graph:

   • 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.

   Tip

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

4. If you chose Graph, select New, enter a name for your graph file, and choose where you want to save it. Select Save.

To create a Script State from an existing Script Graph:

1. With a State Graph open in the Graph window, right-click on an empty space in the Graph Editor to open the context menu. For more information on creating State Graphs, see Creating a new graph file.

2. From the context menu, select Create Script State. Visual Scripting creates a new Script State node.

3. In the Graph Inspector, set your Source to Graph.

   Tip

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

4. In the Graph field, select the target icon and choose a compatible Script Graph from your project. You can also click and drag a Script Graph file from your Project window and drop it into the Graph field.

Tip

For a faster way to add a Script Graph as a Script State, 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. With a State Graph open in the Graph window, right-click on an empty space in the Graph Editor to open the context menu. For more information on creating State Graphs, see Creating a new graph file.

2. From the context menu, select Create Any State.

Create a Super State

To create a new blank Super State:

1. With a State Graph open in the Graph window, right-click on an empty space in the Graph Editor to open the context menu. For more information on creating State Graphs, see Creating a new graph file.

2. From the context menu, select Create Super State. Visual Scripting creates a new Super State node.

3. In the Graph Inspector, choose a source for your new Super State's State Graph:

   • 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.

   Tip

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

4. If you chose Graph, select New, enter a name for your graph file, and choose where you want to save it. Select Save.

To create a Super State from an existing State Graph:

1. With a State Graph open in the Graph window, right-click on an empty space in the Graph Editor to open the context menu. For more information on creating State Graphs, see Creating a new graph file.

2. From the context menu, select Create Super State. Visual Scripting creates a new Super State node.

3. In the Graph Inspector, set your Source to Graph.

   Tip

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

4. In the Graph field, select the target icon and choose a compatible State Graph from your project. You can also click and drag a State Graph file from your Project window and drop it into the Graph field.

Tip

For a faster way to add a State Graph as a Super State, click and drag the State Graph from your Project window into the Graph Editor to automatically create a Super State node.