Node 3D actions

14 actions in the Node 3D category. Each block mirrors how the action appears in the editor's sidebar.

Face Camera

Every Frame

Face Camera Node 3D

not set

Turns the node so its front faces the active 3D camera, keeping it readable from any angle. Best on update so it tracks the camera each frame.

Input	Type	Default	Description
Node	`Node`	-	The node to keep facing the camera. Leave it empty to turn this node.

Phases Every FramePhysics Works on Node3D

Follow Node

Every Frame

Follow Node Node 3D

Node not set | Target not set | Offset (0.0, 0.0, 0.0) | Speed 8.0

Glides the node toward another node every frame, so it trails the target instead of snapping onto it. With Speed = 8 it keeps a health bar over an enemy head, a pet behind the player or a marker on a minimap, and Follow With Camera does the same for a camera.

Input	Type	Default	Description
Node	`Node`	-	The node that follows. Leave it empty to move this node.
Target	`Node`	-	The node to follow.
Offset	`Vector3`	`(0.0, 0.0, 0.0)`	How far from the target to sit, such as above its head.
Speed	`float`	`8.0`	How fast the node catches up. A bigger value follows tighter.

Phases Every FramePhysics Works on Node3D

Get Distance

Every Frame

Get Distance Node 3D

Node not set | Target not set

Measures the distance from the node to a target and stores it, in world units.

Input	Type	Default	Description
Node	`Node`	-	The node the distance is measured from. Leave it empty to measure from this node.
Target	`Node3D`	-	The node to measure the distance to, such as another Node3D.

Output	Type	Description
Distance	`float`	Where to store the resulting distance, in world units.

Phases StartEvery FramePhysicsEnd Works on Node3D

Get Facing Direction

Every Frame

Get Facing Direction Node 3D

not set

Reads the direction the node is facing and stores it, as a unit vector in global space. Useful to move or shoot straight ahead.

Input	Type	Default	Description
Node	`Node`	-	The node to read the facing of. Leave it empty to read this node.

Output	Type	Description
Forward	`Vector3`	Where to store the facing direction, as a unit vector.

Phases StartEvery FramePhysicsEnd Works on Node3D

Look At

Every Frame

Look At Node 3D

Node not set | Target (0.0, 0.0, 0.0) | Up (0.0, 1.0, 0.0)

Rotates the node so its front faces a point in global space.

Input	Type	Default	Description
Node	`Node`	-	The node to turn. Leave it empty to turn this node.
Target	`Vector3`	`(0.0, 0.0, 0.0)`	The point in global space to face.
Up	`Vector3`	`(0.0, 1.0, 0.0)`	Which direction is up, keeping the node from rolling. It must not point along the looking direction.

Phases StartEvery FramePhysicsEnd Works on Node3D

Move And Collide

Physics

Move And Collide Node 3D

Node not set | Motion (0.0, 0.0, 0.0) | → Hit | → Miss

Moves the body by an amount and stops at the first obstacle, then branches on whether it hit. On a hit it reports the collider, the contact point and the surface normal.

Input	Type	Default	Description
Node	`Node`	-	The body to move. Leave it empty to move this node.
Motion	`Vector3`	`(0.0, 0.0, 0.0)`	How far to move this step, in world units.

Output	Type	Description
Collider	`Object`	The node the body hit.
Point	`Vector3`	The position where the contact happened.
Normal	`Vector3`	The direction the hit surface faces.

Branch	Goes to
Hit	Where to go when the move hits something.
Miss	Where to go when the move hits nothing.

Phases Every FramePhysics Works on CharacterBody3D

Move Towards

Every Frame

Move Towards Node 3D

Node not set | Target (0.0, 0.0, 0.0) | Speed 5.0 | → Arrived | → Moving

Moves the node a step toward a target each frame, stopping once it arrives.

Input	Type	Default	Description
Node	`Node`	-	The node to move. Leave it empty to move this node.
Target	`Vector3`	`(0.0, 0.0, 0.0)`	The point in global space to move toward.
Speed	`float`	`5.0`	How fast to move, in world units per second.

Branch	Goes to
Arrived	Where to go on the frame the node lands on the target.
Moving	Where to go while the target is still ahead.

Phases Every FramePhysics Works on Node3D

Rotate

Every Frame

Rotate Node 3D

Node not set | Axis (0.0, 1.0, 0.0) | Speed 90.0

Rotates the node around an axis. During update or physics the speed is degrees per second; on enter or exit it turns once by that amount.

Input	Type	Default	Description
Node	`Node`	-	The node to spin. Leave it empty to spin this node.
Axis	`Vector3`	`(0.0, 1.0, 0.0)`	The axis to rotate around, such as 0, 1, 0 for the up axis.
Speed	`float`	`90.0`	How fast to rotate, in degrees per second.

Phases StartEvery FramePhysicsEnd Works on Node3D

Rotate Toward

Every Frame

Rotate Toward Node 3D

Turns the node smoothly each frame until its front faces a point, instead of snapping like Look At. Higher speed turns faster.

Input	Type	Default	Description
Node	`Node`	-	The node to turn. Leave it empty to turn this node.
Target	`Vector3`	`(0.0, 0.0, 0.0)`	The point in global space to face.
Speed	`float`	`360.0`	How fast to turn, in degrees per second.
Up	`Vector3`	`(0.0, 1.0, 0.0)`	Which direction is up, keeping the node from rolling. It must not point along the looking direction.

Branch	Goes to
Aimed	Where to go once the front points at the target, give or take a degree.
Turning	Where to go while the front is still off the target.

Phases Every FramePhysics Works on Node3D

Set Position

Every Frame

Set Position Node 3D

Node not set | Position (0.0, 0.0, 0.0)

Places the node at a position, measured in its parent space.

Input	Type	Default	Description
Node	`Node`	-	The node to place. Leave it empty to place this node.
Position	`Vector3`	`(0.0, 0.0, 0.0)`	The new position, in parent space.

Phases StartEvery FramePhysicsEnd Works on Node3D

Set Rotation

Every Frame

Set Rotation Node 3D

Node not set | Angle (0.0, 0.0, 0.0)

Points the node at an angle on each axis, in degrees, replacing whatever rotation it had. Zero puts it back upright. Rotate adds to the current angle instead.

Input	Type	Default	Description
Node	`Node`	-	The node to turn. Leave it empty to turn this node.
Angle	`Vector3`	`(0.0, 0.0, 0.0)`	The angle to point at on each axis, in degrees. Zero is upright.

Phases StartEvery FramePhysicsEnd Works on Node3D

Set Scale

Every Frame

Set Scale Node 3D

Node not set | Scale (1.0, 1.0, 1.0)

Sets the scale of the node.

Input	Type	Default	Description
Node	`Node`	-	The node to resize. Leave it empty to resize this node.
Scale	`Vector3`	`(1.0, 1.0, 1.0)`	The new scale, where 1, 1, 1 is the normal size.

Phases StartEvery FramePhysicsEnd Works on Node3D

Set World Position

Start

Set World Position Node 3D

Node not set | Position (0.0, 0.0, 0.0)

Places the node at a point in global space, ignoring the parent. Set Position uses the parent space instead.

Input	Type	Default	Description
Node	`Node`	-	The node to place. Leave it empty to place this node.
Position	`Vector3`	`(0.0, 0.0, 0.0)`	The new position, in global space.

Phases StartEvery FramePhysicsEnd Works on Node3D

Translate

Every Frame

Translate Node 3D

Node not set | Offset (1.0, 0.0, 0.0)

Moves the node by an offset. During update or physics it is applied per second; on enter or exit it is applied once.

Input	Type	Default	Description
Node	`Node`	-	The node to move. Leave it empty to move this node.
Offset	`Vector3`	`(1.0, 0.0, 0.0)`	The amount to move, in world units.

Phases StartEvery FramePhysicsEnd Works on Node3D