The Visual Scripting editor

Tour the Visual Scripting graph editor, from My Visual Script and the action palette to pin rules, shortcuts, Find References, Diff and Compile.

Last updated Oct 26, 2026Edit this pageVersion 1.0.0

The Visual Scripting editor is where you build a class: double-click a .vscript asset in the Content Browser to open it. This page walks through the layout, how pins connect, the action palette, and how to find, compare and compile.

Create a class

  1. Pick a parent

    In the Content Browser, right-click a folder and open Visual Script Class. Choose the parent: Actor, Pawn, Character, Player Controller, Game Mode or Game State. Each spawns as its own backing class, so a Character class moves like a character and calls ACharacter's functions on itself.

  2. Name it

    The editor writes NewVisualScriptClass.vscript with an empty BeginPlay graph and starts a rename. The class name is the file name without the extension, so BP_Door.vscript defines class BP_Door.

  3. Open it

    Double-click the asset.

Two layouts

A class with no component slots is a script, and opens in the graph layout. A class with component slots is an actor class with a body, and opens in the class layout.

Graph layoutClass layout
LeftMy Visual ScriptComponents above My Visual Script
CentreThe canvasTabs: Viewport, Construction, Event graph, Class defaults
RightDetails and Visual Script defaults tabsDetails
BottomDebugger, Compiler results, Find results tabsStrips under the canvas
ToolbarSave, Compile, Diff, Find, Bookmarks, Resume, Step into, Step over, Stop, SimulateSave, Compile, Diff, Find, Class settings, Class defaults, Simulate

The Viewport tab draws the class's component slots as the constructed actor would show them: every mesh slot at its slot transform, through the attach chain.

Visual Scripting editor in the graph layout with BP_Door open: the My Visual Script panel on the left with its Graphs, Functions, Macros, Variables and Event dispatchers sections, the OnInteract graph on the canvas with a Branch and three Call nodes inside a comment box, the Details tab on the right, and the Debugger, Compiler results and Find results tabs below
The graph layout.
Visual Scripting editor in the class layout with a class that has a MeshRenderer slot and a Trigger slot: the Components panel above My Visual Script on the left, the Viewport tab active in the centre showing the mesh, and the Construction, Event graph and Class defaults tabs beside it
The class layout, for a class with component slots.

My Visual Script

My Visual Script lists the class members in five sections: Graphs, Functions, Macros, Variables and Event dispatchers. Functions, macros and dispatchers have a + in their heading. Event graphs and variables are added from the fields Add event graph... and Add variable... at the bottom of their lists. Name an event graph after a lifecycle event, such as Tick or OnTriggerEnter, to handle it. The + in the panel header adds a function, macro, dispatcher or component.

Select a member to edit it in Details. Class settings covers the class name, parent and interfaces; Class defaults lists the default value of every variable.

Nodes and pins

A node is one operation: an event entry, a call, a branch, a math op, a variable read. Its pins are the connection points on its edges:

  • Exec pins carry the order of execution. An exec output wires to the next node's exec input.
  • Data pins carry values: a bool, an int, a float, a string, a vector, an object or a struct.

A node with no exec pins is pure. The VM evaluates it on demand when a downstream data pin reads it. Math nodes, variable reads and const C++ getters are pure.

Connection rules

The editor only lets you draw a wire the VM can run. The editor's pin types are Exec, Bool, Int, Float, String, Vector, Object, Struct and Wildcard.

FromToAllowed
ExecExecYes
ExecData, or data to execNo
IntFloat, or Float to IntYes. The value is converted to the parameter type before a call.
WildcardAnythingYes
Any other pairSame typeYes
Any other pairDifferent typeNo

The action palette

Right-click the empty canvas to open the action palette, or drag off a pin to see only the entries that fit that pin. Type to filter by name or category. The built-in entries:

CategoryEntries
EventsEvent
Flow ControlBranch, Sequence, For Loop, While Loop, Do Once, Flip Flop, Delay, Return, Reroute, For Each Loop, Switch On Value, Gate, Set Gate, Do N, Multi Gate, Break Loop
MathMath (Pure Op), Math Expression...
StructMake Vector, Break Vector
UtilitiesSelect, Is Valid
ObjectSelf, Get Actor By Name, Get Actor By Tag, Cast To, Objects Equal, Call On Target
Event DispatchersBind Event On Target, Unbind Event On Target, and Broadcast for each of the class's dispatchers
VariablesGet Variable, Set Variable, Get Local Variable, Set Local Variable, Get Property, Set Property, and Get and Set for each class variable
ArrayMake Array, Array Get, Array Length, Array Contains, Array Find, Array Add, Array Set, Array Remove Index, Array Clear
MapMake Map, Map Find, Map Contains, Map Length, Map Keys, Map Add, Map Remove, Map Clear
GraphTimeline, Implements Interface
NetworkingHas Authority, Switch Has Authority
ClassClass Reference
TextMake Localized Text
AsyncEvery registered async action. See Node libraries.
CommentComment
FunctionsThe class's own functions, and every reflected function an actor can call on itself
Macros, Macros (Standard)The class's own and inherited macros, then the shipped standard macros
Name LibraryOne category per reflected M<Name>Statics class, for example Gameplay Library

The reflected entries come from the node catalogue, which walks every reflected class and flattens its MFUNCTIONs, so a new MFUNCTION shows up with no registration step VisualScriptNodeCatalog. An RPC function shows its direction beside its name.

Math Expression... asks for an expression such as a * b + 2 and builds the pure node graph for it VisualScriptExpression.

Visual Scripting editor canvas with the action palette open after a right-click on empty space, the search field containing 'loop', and the Flow Control results For Loop, While Loop, For Each Loop and Break Loop listed
The action palette, filtered by typing.

Comments

A comment is a titled box around a group of nodes. The VM ignores it. Select some nodes and press C to wrap them in a comment. Moving a comment moves the nodes inside it. Drag its corner to resize it.

Mouse and keyboard

ActionInput
PanRight-mouse drag
ZoomMouse wheel
Open the palette, or a node's context menuRight-click without dragging
Box-selectLeft-drag on empty canvas
Frame the selectionF
Frame the whole graphHome
Wrap the selection in a commentC
Rename the selected nodeF2
Toggle a breakpoint on the selectionF9
Nudge the selection one grid cellArrow keys
Align two or more nodesShift + arrow keys
Straighten two or more nodesQ
Select all, copy, cut, paste, duplicateCtrl+A, Ctrl+C, Ctrl+X, Ctrl+V, Ctrl+D
Undo, redoCtrl+Z, Ctrl+Y
DeleteDelete or Backspace
FindCtrl+F
Bookmark the selected nodeCtrl+B
SaveCtrl+S

The canvas bindings come from the shared graph widget.

The node context menu

Right-click a node for its actions: breakpoints, conditional breakpoints and logpoints (see Debugging), Open Function Graph on a call, Find References to ..., Collapse to Function, Collapse to Macro, Duplicate, Copy, Break All Links and Delete. Some kinds add their own entries: a Timeline edits its tracks and curves, a Make Localized Text node has Edit Localized Text.... A selection that holds a latent node such as Delay cannot collapse to a function. See Functions, macros and dispatchers.

Find References

Right-click a node that names something (a function call, a variable get or set, a dispatcher broadcast or bind, a macro, an event, a cast or class reference) and choose Find References to .... Find References to class '...' is always offered for the open class. The search reads every .vscript under the project's Content/. An asset open in the editor is searched as you see it, unsaved edits included VisualScriptReferenceFinder.

Results land in Find results: one row per use, naming how it is used (Call, Get, Set, Bind, Broadcast, Cast, Parent class and so on), the class, the graph and the node. Click a row to jump to the node, opening the other asset first when needed.

Matching follows the way the VM resolves names. A self-only use, such as a graph-function call or a variable get, counts only in the declaring class and its subclasses, so an unrelated class with its own Health is not a reference to yours. A cross-object use, such as Call On Target or a bind to another actor's dispatcher, counts in any class.

Diff

Diff compares the open graph with Against Last Save, Against Depot (HEAD), or Against Revision from the file's recent history when the project is under source control. Nodes are paired by id, so deleting one node does not mark every later node as changed. Each added, removed, changed or moved node and each added or removed link becomes a row, and the diffed nodes are badged on the canvas FVisualScriptGraphDiff.

Compile and save

  1. Compile

    Click Compile. The editor validates the class and lists the results in Compiler results. Each row names the graph and node, and the toolbar pill reads Good to go when the class is clean.

  2. Go live

    A compile with no errors re-registers the class. Placed actors and actors in Play-In-Editor rebind to the new version and keep their variable values.

  3. Save

    Click Save or press Ctrl+S. In a multiplayer Play-In-Editor session, saving also reloads the class in the server and client processes. See Hot reload.

Visual Scripting editor after clicking Compile on a class with one broken Call Function node: the Compiler results tab lists one error naming the graph and node, and the offending node is outlined on the canvas
Compiler results after a failed compile.

Simulate starts Simulate in the level viewport, so the class runs against the open world.

Next

Engine sources

This page describes behavior implemented in these files of the engine repository, checked against commit 5922e6e5e.

  • Engine/Source/Runtime/VisualScripting/Public/VisualScripting/VisualScriptNodeCatalog.h
  • Engine/Source/Runtime/VisualScripting/Public/VisualScripting/VisualScriptReferenceFinder.h
  • Engine/Source/Runtime/VisualScripting/Public/VisualScripting/VisualScriptGraphDiff.h
  • Engine/Source/Runtime/VisualScripting/Public/VisualScripting/VisualScriptExpression.h

Page feedback

Was this page helpful?