ECS Node Reference

This document provides a complete reference for all built-in blueprint nodes with visual examples.

Pin Type Legend

Execution Flow

Entity

Component

Number

String

Boolean

Event Nodes

Lifecycle Events

Lifecycle events as blueprint entry points:

Node	Description	Outputs
EventBeginPlay	Triggered when blueprint starts	Exec, Self (Entity)
EventTick	Triggered each frame	Exec, Delta Time
EventEndPlay	Triggered when blueprint stops	Exec

Custom Events

Custom event nodes allow you to define your own events and trigger blueprint logic from code.

Node	Description	Outputs
EventCustom	Custom event triggered from code	Exec, Custom parameters

Creating Custom Events:

When creating a custom event node in the blueprint editor, you need to set:

• Event Name (eventName): Used to trigger the event from code
• Output Parameters: Data passed by the event, such as damage, amount, etc.

Triggering Custom Events from Code:

// Get the blueprint component from entity
const blueprint = entity.getComponent(BlueprintComponent);

// Trigger custom event with parameters
blueprint.vm?.triggerCustomEvent('OnDamage', {
    damage: 50,
    source: attackerEntity
});

// Trigger event without parameters
blueprint.vm?.triggerCustomEvent('OnPickup');

Receiving Event Data in Blueprint:

Custom event nodes expose passed parameters as output pins:

Event OnDamage

Self

Damage

Print

Exec

Msg

Common Custom Event Examples:

Event Name	Purpose	Parameter Examples
OnDamage	Taking damage	{ damage: number, source: Entity }
OnHeal	Healing	{ amount: number }
OnCollision	Collision detection	{ other: Entity, point: Vector2 }
OnPickup	Picking up items	{ item: Entity }
OnInteract	Interaction	{ player: Entity }
OnDeath	Death	{ killer: Entity }

Example: Game Initialization

Event BeginPlay

Self

Print

Exec

Message "Game Started!"

Example: Per-Frame Movement

Event Tick

Delta Time

Multiply

A

B 100

Result

Set Property

Exec

Target

x

Entity Nodes

Manipulate ECS entities:

Node	Description	Type
Get Self	Get the entity owning this blueprint	Pure
Create Entity	Create a new entity in the scene	Exec
Destroy Entity	Destroy specified entity	Exec
Destroy Self	Destroy the owning entity	Exec
Is Valid	Check if entity is valid	Pure
Get Entity Name	Get entity name	Pure
Set Entity Name	Set entity name	Exec
Find Entity By Name	Find entity by name	Pure
Find Entities By Tag	Find all entities with tag	Pure

Example: Create Bullet

Event BeginPlay

Self

Create Entity

Exec

Exec

Entity

Add Transform

Exec

Entity

Component Nodes

Read and write component properties:

Node	Description	Type
Get Component	Get component of specified type from entity	Pure
Has Component	Check if entity has specified component	Pure
Add Component	Add component to entity	Exec
Remove Component	Remove component from entity	Exec
Get Property	Get component property value	Pure
Set Property	Set component property value	Exec

Example: Modify Position

Get Self

Entity

Get Component

Entity

Transform

Get Property

Target

x

Flow Control Nodes

Control blueprint execution flow:

Node	Description
Branch	Conditional branching (if/else)
Sequence	Execute multiple branches in order
For Loop	Loop specified number of times
For Each	Iterate over array elements
While Loop	Loop while condition is true
Do Once	Execute only once
Flip Flop	Alternate between A and B
Gate	Gate switch control

Example: Conditional Branch

Condition

Exec

Result

Branch

Exec

Cond

True

False

Print

Exec

Msg "Yes"

Print

Exec

Msg "No"

Example: For Loop

Event BeginPlay

For Loop

Exec

First 0

Last 10

Body

Index

Done

Time Nodes

Node	Description	Output
Delay	Delay execution by specified seconds	Exec
Get Delta Time	Get frame delta time	Float
Get Time	Get total runtime	Float

Example: Delayed Execution

Event BeginPlay

Delay

Exec

Duration 2.0

Done

Print

Exec

Msg "After 2s"

Math Nodes

Basic Operations

Node	Description	Inputs	Output
Add	Addition	A, B	A + B
Subtract	Subtraction	A, B	A - B
Multiply	Multiplication	A, B	A × B
Divide	Division	A, B	A / B
Modulo	Modulo	A, B	A % B

Math Functions

Node	Description	Inputs	Output
Abs	Absolute value	Value	|Value|
Sqrt	Square root	Value	√Value
Pow	Power	Base, Exp	Base^Exp
Floor	Floor	Value	⌊Value⌋
Ceil	Ceiling	Value	⌈Value⌉
Round	Round	Value	round(Value)
Clamp	Clamp to range	Value, Min, Max	min(max(V, Min), Max)
Lerp	Linear interpolation	A, B, Alpha	A + (B-A) × Alpha
Min	Minimum	A, B	min(A, B)
Max	Maximum	A, B	max(A, B)

Trigonometric Functions

Node	Description
Sin	Sine
Cos	Cosine
Tan	Tangent
Asin	Arc sine
Acos	Arc cosine
Atan	Arc tangent
Atan2	Two-argument arc tangent

Random Numbers

Node	Description	Inputs	Output
Random	Random float [0, 1)	-	Float
Random Range	Random in range	Min, Max	Float
Random Int	Random integer	Min, Max	Int

Comparison Nodes

Node	Description	Output
Equal	A == B	Boolean
Not Equal	A != B	Boolean
Greater	A > B	Boolean
Greater Or Equal	A >= B	Boolean
Less	A < B	Boolean
Less Or Equal	A <= B	Boolean

Extended Math Nodes

Vector2, Fixed32, FixedVector2, Color and other advanced math nodes are provided by the @esengine/ecs-framework-math module.

See: Math Blueprint Nodes

Example: Clamp Value

Random Range

Min 0

Max 100

Result

Clamp

Value

Min 20

Max 80

Result

Variable Nodes

Blueprint-defined variables automatically generate Get and Set nodes:

Node	Description	Type
Get <varname>	Read variable value	Pure
Set <varname>	Set variable value	Exec

Example: Counter

Event Tick

Delta

Get Count

Value

Add

Exec

A

B 1

Result

Set Count

Exec

Value

Exec

Debug Nodes

Node	Description
Print	Output message to console

Related Documentation

• Math Blueprint Nodes - Vector2, Fixed32, Color and other math nodes
• Blueprint Editor Guide - Learn how to use the editor
• Custom Nodes - Create custom nodes
• Blueprint VM - Runtime API