# Configuring your Visual Scripting preferences You can configure specific preferences in Visual Scripting to control the behavior of the Graph window and your nodes. To configure your preferences for Visual Scripting, go to **Edit** > **Preferences**, and then in the **Preferences** window, select **Visual Scripting**. ## Visual Scripting preferences reference The following tables describe the preferences you can configure in Visual Scripting. ### Core preferences The following preferences control general behaviors across all graph types in Visual Scripting.
Preference Description
Dim Inactive Nodes When enabled, any nodes that aren't yet connected to the logic flow in your graph appear dimmed in the Graph Editor. This provides you with a visual cue that in its current configuration, you aren't using the dimmed node in your graph.
When disabled, Visual Scripting doesn't dim any currently disconnected or unused nodes.
Dim Incompatible Nodes When enabled, while trying to make a connection, Visual Scripting dims all nodes that don't have a compatible connection port for your current connection. When disabled, Visual Scripting doesn't dim nodes that don't have a valid connection port.
Show Variables Help When enabled, Visual Scripting displays a brief explanation of your selected variable scope in the Blackboard window for each variable scope. When disabled, Visual Scripting hides these explanations.
Create Scene Variables When enabled, after creating a Scene variable in the Graph window, Visual Scripting automatically creates a GameObject called Scene Variables, with a Variables component and a Scene Variables script component. When disabled, you have to create the required components on a GameObject yourself to use your Scene variables.
Show Grid When enabled, the Visual Scripting grid is visible in the background of the Graph Editor. When disabled, the Graph Editor hides the grid.
Snap to Grid When enabled, nodes stick or snap to points on the Visual Scripting grid in the Graph Editor. When disabled, nodes move freely and don't automatically snap to grid points.
Pan Speed Set a Pan Speed to control how quickly the Graph Editor moves when panning vertically using the scroll wheel.
Drag Pan Speed Set a Drag Pan Speed to control how quickly the Graph Editor moves when moving a node to the edge of the window.
Zoom Speed Set a Zoom Speed to control how quickly the Graph Editor zooms in or zooms out while setting a zoom level in the Graph window. For more information on zooming in the Graph Editor, see Zoom in/Zoom Out in Choosing a control scheme.
Overview Smoothing Set Overview Smoothing to control how gradually the Graph Editor zooms or pans after selecting the Overview option. For more information on the Overview option, see The Visual Scripting interface.
Carry Children When enabled, Visual Scripting moves all connected child nodes when you move a parent node. When disabled, any connected child nodes don't move when their parent node moves.
NOTE

You can also change this setting from the toolbar in the Graph window. For more information, see The Visual Scripting interface.
Disable Playmode Tint When enabled, Visual Scripting displays all nodes in a Graph window as normal while the Editor is in Play mode. When disabled, Visual Scripting tints all nodes in a Graph window.
Control Scheme Select your desired Visual Scripting control scheme. For more information, see Choosing a control scheme.
Clear Graph Selection When enabled, Visual Scripting clears the Graph window if you select a GameObject with no set graph or graphs. When disabled, Visual Scripting keeps the last displayed graph after selecting a GameObject with no set graph or graphs.
NOTE

Visual Scripting updates the Graph window to display the set graph on your currently selected GameObject, regardless of your chosen Clear Graph Selection setting.
Human Naming When enabled, Visual Scripting converts function names from camel case. For example, camelCase becomes Camel Case. When disabled, Visual Scripting doesn't convert any names.
Max Search Results Set a Max Search Results value to specify the maximum number of search results returned by the fuzzy finder after using the search bar.
Group Inherited Members When enabled, in the fuzzy finder search results, Visual Scripting groups together inherited nodes from a parent or base class to your current search term.
For example, an Audio Source is a Component: it has its own specific methods and nodes, but you can interact with it as a Component by using Component nodes. While searching in the fuzzy finder, Visual Scripting groups the nodes inherited from Component and displays them in grey.
When disabled, the fuzzy finder displays nodes in the search results without grouping these inherited nodes.
Developer Mode When enabled, Visual Scripting provides additional preferences in the Preferences window. It also adds additional features in the Graph window and other areas of the Unity Editor. For more information on the additional Developer Mode preferences, see [Additional Developer Mode preferences.
AOT Safe Mode When enabled, Visual Scripting excludes nodes with types that may cause problems for platforms requiring Ahead Of Time (AOT) compilation from search results in the fuzzy finder. For example, Visual Scripting excludes nodes that use the Generic type.
When disabled, potentially problematic types aren't filtered.
### Script Graphs preferences The following preferences change the behavior of Script Graphs in the Graph window.
Preference Description
Update Units Automatically
NOTE

This feature is experimental.

When enabled, Visual Scripting updates your node library automatically whenever it detects that a script in your project's Assets folder has changed. When disabled, you must manually update your node library. For more information on updating your node library, see Configuring your project settings.
Predict Potential Null References When enabled, Visual Scripting's predictive debugging warns you about potential null value inputs in your graphs. When disabled, predictive debugging doesn't display warnings about potential null values.
NOTE

Sometimes, predictive debugging may return false positives when you enable this setting.
Predict Potential Missing Components When enabled, Visual Scripting's predictive debugging warns you about potential missing components in your graphs. When disabled, predictive debugging doesn't display warnings about potential missing components.
NOTE

Sometimes, predictive debugging may return false positives when you enable this setting.
Show Connection Values When enabled, the Graph Editor shows the input and output values sent between nodes while the Unity Editor is in Play mode. This can make it easier to debug your scripts.
When disabled, the Graph Editor doesn't display input and output values.
Predict Connection Values When enabled, the Graph Editor attempts to predict what input and output values will be sent between nodes while the Unity Editor is in Play mode. For example, Visual Scripting could display the value currently set for a variable in your script, though that value may change before it's used by a node.
When disabled, Visual Scripting won't attempt to predict input and output values.
Hide Port Labels When enabled, Visual Scripting doesn't display the name labels for node input and output ports. When disabled, nodes display these name labels.
Animate Control Connections When enabled, Visual Scripting displays a droplet animation across node logic flow connections while the Editor is in Play mode. When disabled, logic flow connections aren't animated.
Animate Value Connections When enabled, Visual Scripting displays a droplet animation across node value flow connections while the editor is in Play mode. When disabled, value flow connections aren't animated.
Skip Context Menu When enabled, a right-click inside the Graph window opens the Visual Scripting fuzzy finder. To access the context menu, you must Shift + right-click.
When disabled, right-click without a node selected to open the fuzzy finder; right-click with a node selected to open the context menu.
### State Graphs preferences The following preferences change the behavior of State Graphs in the Graph window.
Preference Description
States Reveal Use the dropdown to choose when a Script State node displays a list of events from its graph:
  • Never: Script State nodes never display their list of events.
  • Always: Script State nodes always display their list of events.
  • On Hover: Script State nodes only display their list of events when you hover over the node in the Graph window.
  • On Hover with Alt: Script State nodes only display their list of events when you hover over the node while holding Alt.
  • When Selected: Script State nodes only display their list of events when you select them in the Graph window.
  • On Hover or Selected: Script State nodes display their list of events when you hover over the node, or when you select it in the Graph window.
  • On Hover with Alt or Selected: Script State nodes display their list of events when you hover over the node while holding Alt, or when you select it in the Graph window.
You might want to change this setting if you have a lot of Script State nodes in your State Graphs.
Transitions Reveal Use the dropdown to choose when a transition displays a list of events from its graph:
  • Never: Transitions never display a list of events.
  • Always: Transitions always display a list of events.
  • On Hover: Transitions only display a list of events when you hover over the transition in the Graph window.
  • On Hover with Alt: Transitions only display a list of events when you hover over the transition while holding Alt.
  • When Selected: Transitions only display a list of events when you select them in the Graph window.
  • On Hover or Selected: Transitions display a list of events when you hover over the transition, or when you select it in the Graph window.
  • On Hover with Alt or Selected: Transitions display a list of events when you hover over the transition while holding Alt, or when you select it in the Graph window.
You might want to change this setting if you have a lot of transitions in your State Graphs.
Transitions End Arrow When enabled, Visual Scripting adds an arrow to the end of each transition connection in your State Graphs. When disabled, transition connections display as simple lines.
If you have a lot of transitions in your State Graphs, you might want to leave this setting disabled.
Animate Transitions When enabled, Visual Scripting displays a droplet animation across transition connections when the Editor is in Play mode. When disabled, transition connections aren't animated.
### Additional Developer Mode preferences > [!NOTE] > You can only access the following preferences after you have enabled **Developer Mode**. These Developer Mode preferences provide help with developing extensions or custom nodes for Visual Scripting. Their continued support in the Visual Scripting package isn't guaranteed. |**Preference** |**Description** | |:---|:---| |__Debug__ | When enabled, Visual Scripting adds additional logging and visual overlays to help you debug element rendering in the Graph window. For example, if you created a custom node, enabling this setting might help you to create your desired UI.| |__Track Metadata State__ | When enabled, Visual Scripting adds more information to its logging to help assist with debugging.| |__Debug Inspector UI__ | When enabled, Visual Scripting adds more detail and additional overlays. The information available is greater than what Visual Scripting provides with the **Debug** setting, and affects more areas of the Editor's UI. You should only enable this setting if you need more in-depth debugging feedback.|