Attach a graph file to a Script Machine or State Machine

To use a Script Graph or State Graph file in your project, you must attach it to a Script Machine or State Machine.

A Script Machine or State Machine is a component. Components attach to GameObjects, and help define their behavior. For more information on components and GameObjects, see Using components or GameObjects in the Unity User Manual.

Add a Script Machine or State Machine component to a GameObject

  1. Go to Window > General > Hierarchy, or press Ctrl+4 (macOS: Cmd+4) to open the Hierarchy window.

  2. In the Hierarchy window, select a GameObject where you'd like to add a Script Machine or State Machine.

  3. With the GameObject selected in the Hierarchy window, go to Window > General > Inspector, or press Ctrl+3 (macOS: Cmd+3) to open the Inspector window.

  4. In the GameObject's Inspector window, select Add Component.

    The Components menu opens.

  5. Do one of the following:

    • To add a Script Machine or State Machine, in the Components menu, go to Visual Scripting and select Script Machine or State Machine.
    • Use the search bar to find the Script Machine or State Machine component.

The new Script Machine or State Machine component appears in the Inspector window for the GameObject:

A new blank Script Machine component in the Inspector window for a GameObject

Attach a graph file to the Script Machine or State Machine

  1. In the Inspector window, locate your Script Machine or State Machine component.

  2. Set the Source to Graph.

  3. Do one of the following:

    • In the Graph field, select the object picker (circle icon) and choose a compatible graph file from your project.
    • Click and drag a file from your Project window and drop it into the Graph field.

For more information on how to create Script or State Graphs, see Create a new graph file.

Next steps

After you attach a graph to a Script Machine or State Machine, you can open the graph and edit. For more information, see Open a graph file.