docs.unity3d.com
  • Manual
  • Scripting API
  • Changelog
  • License
    Show / Hide Table of Contents
    • About Visual Scripting
      • Configure project settings
        • Add or remove available nodes
        • Add or remove types
        • Create or restore a backup
      • Choose a control scheme
      • Configure your preferences
      • Update Visual Scripting
      • Version control systems
      • Use Visual Scripting with Unity Cloud Build
    • Basic concepts in Visual Scripting
      • The interface
      • Nodes
      • Graphs
        • Subgraphs and State Units
        • Transitions
      • Script Machines and State Machines
      • Object types
        • Custom types
      • Variables
    • Develop application logic with Script Graphs
      • Create a new graph file
        • Create a new blank graph with the Project window
        • Create a new unassigned graph with the empty graph creation flow
        • Create and assign a graph to an existing Game​Object
        • Create and assign a graph to a new Game​Object
        • Create a graph on a Script Machine or State Machine
      • Attach a graph file to a Script Machine or State Machine
      • Open a graph file
        • Add a node to a Script Graph
        • Connect nodes in a Script Graph
        • Create and add a variable to a Script Graph
        • Create node groups
        • Add comments to a graph
      • Add a Subgraph to a Script Graph
        • Add a Trigger or Data port to a Script Graph
      • Add a State Unit to a Script Graph
      • Custom Events
        • Add a Custom Event node
        • Add a Trigger Custom Event node
      • Capture user input in an application
        • Capture input using the Input Manager
        • Add and configure a Player Input component
        • Capture input using the Input System package
      • Use relations to debug
        • Predictive and live debugging
        • Working with debug messages
      • Live edit
        • Live edit during runtime
    • Develop logic transitions with state graphs
      • Create a new state
      • Create a transition between states
    • Advanced customization and development
      • Refactor a C# script with Visual Scripting
        • Add the Renamed​From attribute to a C# script
      • Custom C# nodes
        • Create a new simple Custom C# node
        • Add ports to your Custom C# node
        • Add logic to your Custom C# node
        • Add relations to your Custom C# node
        • Add documentation to your Custom C# node
        • Custom C# node attributes reference
      • Create a Custom Scripting Event node
        • Create a Custom Scripting Event Sender node
        • Trigger a Custom Scripting Event from a C# script
        • Listen to a Custom Scripting Event from a C# script
      • Use a custom type
        • Add the Inspectable attribute to a custom type
        • Create a custom Property​Drawer for a custom type
    • Node reference
      • This node
      • Control node
      • Time node
      • Events
        • Event nodes
        • Input Event nodes
          • On Input System Event Button
          • On Input System Event Float
          • On Input System Event Vector 2
          • On Button Input
          • On Keyboard Input
          • On Mouse Down
          • On Mouse Drag
          • On Mouse Enter
          • On Mouse Exit
          • On Mouse Input
          • On Mouse Over
          • On Mouse Up As Button
          • On Mouse Up
      • Variable node
      • Nulls node
      • Formula node
      • Nesting
        • Input node
        • Output node
        • State Unit node
        • Subgraph node
      • Script graph nodes
      • State graph nodes
    • Developer's guide
    • Manual
    • Develop logic transitions with state graphs
    • Create a transition between states

    Create a transition between states

    To switch between states in a State Graph, you must use a Script Graph called a transition.

    For more information on State Graphs, see State Graphs.

    Create a transition with an embedded Script Graph

    To create a new transition to another state with an embedded graph in a State Graph:

    1. With a State Graph open in the Graph window, do one of the following:

      • Right-click on the state where you want to make a transition, then in the context menu, select Make Transition.

      • Select the state where you want to make a transition, then press Ctrl+click and drag away from your selected state.

    2. Do one of the following:

      • Select or release while on an existing state in your State Graph to connect the states with a transition.

      • Select or release while on an empty space in the Graph Editor to automatically create a new blank Script State at the end of your transition.

    3. Select your transition node.

    4. Open the Graph Inspector.

    5. In the Graph Inspector, set the Source to Embed.

    6. In the (Title) field, enter a title for your transition's Script Graph.

    7. In the (Summary) field, enter a brief descriptive summary of your transition's Script Graph.

    Note

    If you choose to use an embedded transition Script Graph, Visual Scripting automatically provides the Trigger Transition node you need for the graph.

    Create a transition with an external Script Graph file

    To create a new transition with a graph asset file in a State Graph:

    1. With a State Graph open in the Graph window, do one of the following:

      • Right-click on the state where you want to make a transition, then in the context menu, select Make Transition.

      • Select the state where you want to make a transition, then press Ctrl+click and drag away from your selected state.

    2. Do one of the following:

      • Select or release while on an existing state in your State Graph to connect the states with a transition.

      • Select or release while on an empty space in the Graph Editor to automatically create a new blank Script State at the end of your transition.

    3. Select your transition node.

    4. Open the Graph Inspector.

    5. In the Graph Inspector, set the Source to Graph.

    6. Do one of the following:

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

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

      • Select New and create a new Script Graph.

    7. Double-click the new transition node to open the transition Script Graph.

    An image of a new blank transition Script Graph open in the Graph window.

    Create a self transition with an embedded Script Graph

    To create a new self transition for a state in a State Graph:

    1. With a State Graph open in the Graph window, right-click on the state where you want to make the transition.

    2. In the context menu, select Make Self Transition. Visual Scripting attaches a new Self Transition node to the state in the State Graph automatically.

    3. Select your transition node.

    4. Open the Graph Inspector.

    5. In the Graph Inspector, set the Source to Embed.

    6. In the (Title) field, enter a title for your transition's Script Graph.

    7. In the (Summary) field, enter a brief descriptive summary of your transition's Script Graph.

    8. Double-click the new self transition to open the transition Script Graph.

    An image of a State Graph with a Script State node that has a self transition.

    Note

    If you choose to use an embedded transition Script Graph, Visual Scripting automatically provides the Trigger Transition node you need for your graph.

    Create a transition with an external Script Graph file

    To create a new transition with a graph asset file in a State Graph:

    1. With a State Graph open in the Graph window, right-click on the state where you want to make the transition.

    2. In the context menu, select Make Self Transition. Visual Scripting attaches a new Self Transition node to the state in the State Graph automatically.

    3. Open the Graph Inspector.

    4. In the Graph Inspector, set the Source to Graph.

    5. Do one of the following:

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

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

      • Select New and create a new Script Graph.

    6. Double-click the new transition node to open the transition Script Graph.

    In This Article
    • Create a transition with an embedded Script Graph
    • Create a transition with an external Script Graph file
    • Create a self transition with an embedded Script Graph
    • Create a transition with an external Script Graph file
    Back to top
    Terms of use
    Copyright © 2023 Unity Technologies — Terms of use
    • Legal
    • Privacy Policy
    • Cookies
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)
    "Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S. and elsewhere (more info here). Other names or brands are trademarks of their respective owners.
    Generated by DocFX on 18 October 2023