Node Finder - RealityStop/Bolt.Addons.Community GitHub Wiki

Node Finder Window

Node Finder is a powerful search utility for Unity Visual Scripting that allows you to quickly locate Nodes, States, Comments, Sticky notes, Groups and Errors across your entire project.

Features

  • Project-Wide Search: Scan through all selected graph providers to find specific nodes or references.
  • Search Modes: Toggle between Contains and StartsWith to refine your results.
  • Quick Navigation: Select a result to immediately focus or open the corresponding graph.

Opening the Window

The Node Finder can be accessed in several ways:

  1. Menu Bar: Navigate to Window > Community Addons > Node Finder.
  2. Keyboard Shortcut: Press Alt + F (Default shortcut).

Search Modes

You can switch search logic via the dropdown in the toolbar:

  • Contains: Finds the search term anywhere within the node or group name.
  • StartsWith: Only shows results that begin with your search term.

Layout Sections

1. Search Toolbar

The top bar contains the search field, the Search trigger button, and the Search Mode toggle. Pressing Enter or clicking Search will refresh the results list.

2. Results List

Displays a list of matches including:

  • Icon: Visual representation of the object type.
  • Path: Shows the breadcrumb path of where the node is located (Group > Graph).
  • Depth: Indicates how nested the node is within subgraphs.

Developer Integration

The Node Finder uses a provider-based architecture. You can extend its functionality by implementing:

  • IGraphProvider and GraphProviderAttribute: Add new sources for the search engine to scan.
  • IMatchHandler and MatchHandlerAttribute: Define how the window should react when a specific type of match is selected.

[!NOTE] The Node finder will search through All assets and Loaded scenes depending on the Selected Graph providers.

Advanced search

In the window you can click on the ? button it will give you all the info you need on how use advanced search.