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.

An image of a State Graph with a new blank Script State node.

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.

An image of a State Graph with a Script State node with an existing Script Graph.

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. With a State Graph open in the Graph window, right-click on an empty space in the Graph Editor to open the context menu.

  2. Select Create Any State.

An image of a State Graph with a new Any State node

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.

An image of a State Graph with a new blank Super State node.

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.

An image of a State Graph with a Super State node with an existing State Graph.

Tip

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