Node libraries

The reflected Statics libraries that appear as palette categories, the functions every actor calls on itself, the async actions and the standard macros.

Last updated Nov 3, 2026Edit this pageVersion 1.0.0

You never register a node. The node catalogue walks every reflected class and flattens its MFUNCTIONs, so anything a module reflects is placeable VisualScriptNodeCatalog. This page lists what ships: the Statics libraries, the functions every actor exposes on itself, the async actions and the standard macros. For each function's parameters, open the class in the API reference.

How libraries appear

A reflected class whose name ends in Statics gets its own palette category: the leading M and the trailing Statics are dropped and Library is added, so MGameplayStatics is Gameplay Library. A placed node stores the qualified name, such as MGameplayStatics::SpawnActorByClass, and the VM calls it on the class's default object, so no target pin is needed. A const function is a pure node.

A library from a feature module or a plugin appears once that module is loaded and the plugin is enabled. Your game module's own Statics classes appear the same way.

Engine libraries

ClassModuleCovers
MGameplayStaticsGameSpawn and destroy actors, actor location and rotation, the player pawn, the game instance, traces, damage, world time, pause and time dilation
MActorStaticsGameAttachment, velocity and impulses, orientation vectors, scale, tags, counting and indexing actors by class or tag
MDebugStaticsGamePrint String and the Draw Debug shapes. Every call does nothing in release and profile builds.
MStringStaticsGameString operations, all pure
MMathStaticsGameInterpolation, angles, vectors, rotators, FTransform Make and Break
MTimerStaticsGameTimers that fire an input pin; pause, resume and clear
MInputStaticsGameInput action state, input contexts, gamepad family and glyphs, the on-screen keyboard
MLevelStaticsGameActors near a point, actor by name, keyed scene values, spawn at a transform, streaming regions and data layers
MCameraStaticsGameCamera shakes and view targets
MMovementStaticsGameProjectile movement, rotating movement and spring arms
MPhysicsStaticsGamePhysics materials on an actor's collider
MConstraintStaticsGameSwitch, re-point, break and drive an actor's Constraint
MPhysicsInteractableStaticsGamePhysics interactables
MImpactStaticsGameImpacts
MWaterStaticsGameWater queries
MAcousticsStaticsGameGeometric acoustics: echoes, paths and the listener's room
MSaveStaticsGameCheckpoints, save slots and MSaveGame objects
MPlayerStateStaticsGameReplicated player records: name, score, team, ready. Setters run on the host only.
MAttentionStaticsGameThe Attention meter
MStatusEffectStaticsGameStatus effects
MRewindStaticsGameTime rewind
MRollbackStaticsGameRollback netcode input and session health
MLiveOpsStaticsGameRemote config, experiments and telemetry events
MModStaticsGameLoaded mods and the switches a mod menu needs
MRenderingStaticsGameThe active graphics API, and requesting a different one at next start
MAudioStaticsAudioBus mixer and fire-and-forget playback
MUIStaticsArcUIGame UI screens. See UI.
MRebindStaticsArcUIInput remapping for a custom controls screen
MSmartObjectStaticsAINavigationClaim and release smart object slots
MStateTreeStaticsAINavigationSend events to a state tree, read its state, write its blackboard
MCrowdStaticsAINavigationCrowds
MDirectorStaticsAINavigationThe AI director
MSituationStaticsAINavigationSituations
MDialogueStaticsNarrativeDialogue
MQuestStaticsNarrativeQuests
MSubtitleStaticsNarrativeSubtitles
MMusicStaticsNarrativeMusic
MMixSnapshotStaticsNarrativeMix snapshots
MVoxelDestructionStaticsDestructionCarve voxel destructibles
MPcgStaticsPCGRegenerate PCG volumes and read back what they placed
MSequenceStaticsSequencerSequences
MVoiceChatStaticsVoiceChatMute and per-player volume

Functions on self

Without a library prefix, a call resolves on the running instance's own class chain. AActor exposes GetActorLocation, SetActorLocation, GetActorName, SetActorHiddenInGame, GetComponentByClass, GetComponentByName and GetComponentCount AActor. A component returned by a getter is an object pin: call its functions with Call On Target. Pawn, Character, controller, game mode and game state classes reach their native base's reflected functions the same way. See Calling C++.

Async actions

An Async Action node starts an action and resumes the graph on the pin the action fires. These ship with the engine:

ActionInputsFires
Timed WaitDurationOn Completed, with the elapsed time
Delay Until Next TickOn Next Tick
Wait For Gameplay EventEvent NameOn Event, with the payload
Async Load AssetAsset PathOn Loaded with the asset, or On Failed
AI Move ToPawn, Destination, Acceptance RadiusOn Arrived, or On Failed
Wait Input ActionAction, Test Already PressedOn Pressed with the seconds waited, then On Released with the seconds held; On Failed
Wait OverlapTrigger, Tag Filter, TimeoutOn Overlap with the entering actor, On Timeout, or On Failed
Wait Attribute ChangeTarget, Attribute, Trigger OnceOn Changed with the new value, or On Failed

Wait Input Action ignores a press already held when it starts unless Test Already Pressed is set. Wait Overlap counts only actors that enter after it starts; an empty Trigger means the graph's own actor. Wait Attribute Change keeps listening for the life of the graph unless Trigger Once is set.

Warning

Async Load Asset, AI Move To and the three Wait actions rely on a provider installed by a higher module: the asset system, the AI navigation module and the gameplay layer. In a host without one, the node takes On Failed on its first tick and logs what is missing.

A game module can add its own action, or replace a shipped one by registering under the same name, with VisualScriptAsyncRegistry::Register VisualScriptAsyncRegistry.

Standard macros

Two macros ship with the engine and appear under Macros (Standard) in every class:

MacroInputsOutputsDoes
IsValidBranchIn (exec), ObjectIsValid, NotValid (exec)Checks an object and branches in one node.
ForEachWithBreakIn (exec), Array, Break (exec)LoopBody (exec), Element, Index, Completed (exec)A For Each whose body can fire Break to stop early.

Next

Engine sources

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

  • Engine/Source/Runtime/VisualScripting/Public/VisualScripting/VisualScriptNodeCatalog.h
  • Engine/Source/Runtime/VisualScripting/Public/VisualScripting/VisualScriptAsync.h
  • Engine/Source/Runtime/Game/Public/Game/AActor.h
  • Engine/Source/Runtime/Game/Public/Game/MGameplayStatics.h
  • Engine/Source/Runtime/Game/Public/Game/MDebugStatics.h
  • Engine/Source/Runtime/Game/Public/Game/MStringStatics.h
  • Engine/Source/Runtime/Game/Public/Game/MMathStatics.h
  • Engine/Source/Runtime/Game/Public/Game/MTimerStatics.h

Page feedback

Was this page helpful?