Path3D in Godot – Complete Guide

Navigating the intricate world of 3D game development can sometimes feel like steering a ship through unfamiliar waters. To chart a clear course, understanding tools like the Path3D class in Godot 4 is crucial, as it helps in creating dynamic and natural movements within games. Using paths, developers can direct objects along predefined trajectories, giving them life and purpose within the virtual realms they inhabit. Let’s set sail on the journey to understanding and utilizing Path3D in your Godot 4 projects to bring your game worlds to life.

What is Path3D?

Path3D is a versatile class in Godot 4 that represents a 3D path for objects to follow within a game world. It is a node that holds a Curve3D object, which defines a series of interconnected points in 3D space, forming the path for the objects.

What is it for?

The primary use of Path3D is to give a defined trajectory for other nodes, like PathFollow3D, to move along. This can be instrumental for:

  • Animating characters and objects seamlessly through complex paths.
  • Creating sophisticated movement patterns without the need for intricate programming.
  • Designing engaging and dynamic environments that react to gameplay.

Why Should I Learn It?

Understanding Path3D opens up a new dimension in game design where you can easily manipulate the movement of 3D objects:

  • It saves time and provides more control over movement within a 3D space.
  • It can enhance your game’s visual appeal by creating smooth and realistic movement paths.
  • It is a great stepping stone into more complex 3D game development tasks.

Learning how to implement and use Path3D efficiently is a valuable skill for any aspiring or experienced game developer wanting to add flair to their game’s mechanics.

CTA Small Image

Creating and Configuring a Path3D

To kick things off, let’s start by creating a Path3D node in our scene and configure it with a simple curve.

var path =
var curve =

curve.add_point(Vector3(0, 0, 0))
curve.add_point(Vector3(0, 5, 5))
curve.add_point(Vector3(5, 5, 10))
curve.add_point(Vector3(10, 0, 15))

path.curve = curve

This straightforward script shows how to create a new Path3D node, set up a basic Curve3D with four points, and attach the Path3D to our current scene.

Adding a PathFollow3D Node

Next, we need to make an object follow our path. For that, we attach a PathFollow3D node to the Path3D node and configure it.

var follow =

# Let's set it to loop and follow the curve closely
follow.loop = true
follow.unit_offset = 0.0

The PathFollow3D node will be the pivot for the object that moves along the path. Looping lets the object repeat the path continuously. ‘unit_offset’ positions it at the start of the path.

Moving an Object along the Path

With the path and follower set up, we can make an object, like a Spatial node or a MeshInstance, follow the path. First, we’ll attach the object as a child of PathFollow3D.

# Assuming "mesh_instance" is already a MeshInstance node we want to move

# Ensure that mesh_instance is positioned correctly
mesh_instance.translation = Vector3.ZERO

By ensuring that the MeshInstance’s translation is set to zero, we make sure it’s at the pivot point of the PathFollow3D node.

Now we can animate the ‘unit_offset’ of the PathFollow3D to move the mesh_instance along the path.

# Animate 'unit_offset' from 0 to 1
follow.animate_property("unit_offset", 0.0, 1.0, 10.0, Tween.TRANS_LINEAR,Tween.EASE_IN_OUT)

Animating the ‘unit_offset’ from 0.0 to 1.0 will move the object from the start of the path to the end over 10 seconds.

Modifying the Path at Runtime

You might want to change the path dynamically during gameplay. You can add, delete, or modify the points in the Curve3D associated with the Path3D.

# Add a new point to the curve
path.curve.add_point(Vector3(15, 5, 20))

# Remove the first point from the curve

# Modify an existing point (the new second point)
path.curve.set_point_position(2, Vector3(5, 10, 15))

This flexibility allows for dynamic environments or levels that can adjust based on player actions or other in-game events.

Wrapping Up

Through these examples, we’ve seen how to create a path, make an object follow it, and how we can modify the path even while the game is running. In the next part of our tutorial, we’ll dive into more advanced features and provide additional examples to truly master the capabilities of Path3D in Godot 4. Stay tuned as we continue our journey to create more sophisticated 3D pathways!In this continued exploration, we’ll delve further into unveiling the full potential of Path3D and PathFollow3D nodes. With these advanced techniques, you can create even more dynamic and interactive 3D movement within your Godot 4 games.

One powerful feature of Path3D is the ability to influence the way objects move along the path. You may want the object to accelerate or decelerate, or perform complex movement patterns—like slowing down at curves. Godot’s Tween node comes to the rescue here.

Using Tween for Complex Movement

Animating PathFollow3D’s ‘unit_offset’ with a Tween node allows for smooth transitions.

var tween =



In the above code snippet, we’ve added a Tween node to our scene and set it to interpolate the ‘unit_offset’ property of our PathFollow3D node with a quadratic transition, which provides a natural acceleration and deceleration effect.

Reversing Directions

Sometimes, you might want an object to move back and forth along a path, rather than in a single direction. You can achieve this by toggling the direction of ‘unit_offset’.

var forward = true

# Call this method to change direction
func toggle_movement_direction():
    forward = !forward

# Use this within the _process(delta) function to continuously update 'unit_offset'
if forward:
    follow.unit_offset += delta * speed
    follow.unit_offset -= delta * speed

The ‘toggle_movement_direction’ function switches the direction, while the ‘_process’ function continuously updates the ‘unit_offset’ based on whether we are moving forward or backward.

Reacting to Player Input

Paths can also be interactive. Imagine a game where the player controls the speed of an object on a path.

# Inside your _process or _input function
if Input.is_action_pressed("ui_right"):
    follow.unit_offset += delta * speed
elif Input.is_action_pressed("ui_left"):
    follow.unit_offset -= delta * speed

With these Input calls, the object moves along the path according to player input, increasing the sense of interaction.

Adding Offsets for Variation

Another useful trick is to introduce variations along the path using offsets. This can give the appearance of objects straying slightly from the path—for example, side-to-side oscillation.

var side_offset = 0.0
var amplitude = 2.0
var frequency = 1.0

# Update this in _process to oscillate the side_offset
side_offset = sin(follow.unit_offset * frequency) * amplitude
mesh_instance.translation.x += side_offset

This code applies a sinusoidal offset to the object’s X translation, based on its progress along the path, to create a side-to-side movement.

Creating Branching Paths

Finally, you might want branching paths for more complex scenarios. You can dynamically switch the object’s path at runtime.

# Assume "path_alternate" is another Path3D instance in the scene
func switch_to_alternate_path():
    var new_follow =
    # Now start moving on the alternate path

This snippet swaps our MeshInstance from its current path to an alternate one, allowing you to create dynamic, branching paths in your game.

Through these examples, it’s clear that Godot’s Path3D and PathFollow3D nodes facilitate complex, yet easily manageable, 3D movement within games. As we’ve demonstrated, the possibilities are vast, empowering you to craft a more engaging and interactive gaming experience. Whether you’re creating a racing game with varying speed zones or a puzzle game where objects move along specific tracks, mastering these nodes will elevate the quality of your gameplay significantly.Certainly! We’ll expand on more sophisticated uses of Path3D with Godot 4, enabling you to enhance your game’s level design and interactivity. These code examples will build on the previous discussion, showcasing practical applications and more intricate control over the paths.

Adjusting Path at Runtime for Dynamic Levels

Changing the path’s shape on-the-fly allows for dynamic level designs that can surprise players and keep gameplay fresh.

# Let's modify a control point of the curve to change the shape of the path
var new_control_point_position = Vector3(10, 5, 15)
path.curve.set_point_position(1, new_control_point_position)

This code modifies the second point of our path (index 1), creating a new shape that could represent a moving platform or shifting landscape in-game.

Attaching Multiple Objects to a Path

PathFollow3D nodes can be used for more than one object. Let’s say we want a group of objects moving together like a flock or convoy:

for i in range(5):
    var new_follower =
    new_follower.offset = i * 2  # Spacing out the followers
    var new_mesh = create_mesh_instance()  # Assume this is a function returning a MeshInstance

With this loop, we create a series of followers, each with a MeshInstance. We space them out by modifying each one’s ‘offset’ property.

Synchronizing Movements with Signals

PathFollow3D nodes emit signals when reaching the end of a path. You can connect these signals to trigger events or behaviors.

# Connect the 'finished' signal to a custom method
follow.connect("finished", self, "_on_path_finished")
func _on_path_finished():
    print("Reached the end of the path!")
    # Add code here to trigger any desired behavior

Here, when an object reaches the end of a non-looping path, we print a message to the console. This same pattern could be used to trigger other in-game events like spawning enemies or changing the environment.

Controlling Path Visibility

During development, it might be useful to see the path for debugging purposes, but you may want it hidden during gameplay.

# Set 'visible' property to true or false to show or hide the path
path.visible = true  # Show in the editor for debugging
path.visible = false  # Hide during gameplay

Toggle visibility as needed; this doesn’t affect the path’s function, only its visibility in the editor and game.

Creating Looped and Non-looped Paths

Loops can create continuous circuits, while non-looped paths can serve for point-to-point movement.

# Set loop property based on the game design
path.curve.loop = true  # Create a looped path for endless movement
path.curve.loop = false  # Create a start and end point, no loop

Choosing between looping or non-looping paths can drastically change how objects move within your level.

Using PathFollow3D’s ‘rotation_mode’

PathFollow3D can also control the rotation of objects to align with the path’s direction, which is very useful for vehicles or AI characters.

# Set rotation mode to align your object with the path direction
follow.rotation_mode = PathFollow3D.ROTATION_ORIENTED
# Or keep the object's original rotation
follow.rotation_mode = PathFollow3D.ROTATION_NONE

‘ROTATION_ORIENTED’ will make the node rotate to follow the curve’s tangent, whereas ‘ROTATION_NONE’ will keep it upright relative to the world.

Implementing Offsets for Elevation Changes

When structuring paths with varying elevations, you may want objects to retain a consistent altitude relative to the ground or other points of reference.

# Assume "calculate_altitude_offset" is a function to determine the right elevation
var altitude_offset = calculate_altitude_offset(follow.global_transform.origin)

# Apply the offset to the PathFollow3D node
follow.translation.y += altitude_offset

This code adjusts the Y position, adding an altitude offset to the PathFollow3D node to maintain a certain height, perhaps for flying creatures or aircraft.

Incorporating these functionalities into your games unlocks a higher level of dynamism and engagement. As with learning any tool, practice with these concepts and they will soon become second nature, allowing for rapid development of intricate 3D movement in your Godot 4 projects. Remember, each game’s requirements are unique, so feel free to customize and extend these examples to fit your specific development needs. Happy coding!

Where to Go Next with Your Godot 4 Journey

Congratulations on exploring the advanced functionalities of the Path3D and PathFollow3D nodes in Godot 4! Your journey through 3D game development doesn’t have to end here. We at Zenva are excited to offer a slew of resources to take your Godot skills to new heights. Our Godot Game Development Mini-Degree is a treasure trove of knowledge, perfect for anyone looking to expand their understanding of cross-platform game development with the Godot engine.

This comprehensive program covers a wide variety of essential topics, from grasping GDScript and controlling gameplay flow to mastering different game mechanics across RPGs, RTS, and more. Whether you’re a neophyte to the realm of game development or seeking to hone your existing skills, the Mini-Degree offers a tailored learning path complemented by projects that enrich your portfolio and cement your know-how.

For an even broader spectrum of Godot courses, make sure to check out our collection of Godot tutorials. With over 250 supported courses, Zenva is the go-to platform to reinforce your programming dexterity, elevate your game creation prowess, and unlock career opportunities in the bustling game development industry. Keep learning, keep creating, and watch as your virtual worlds take flight with Zenva!


If your passion for game development knows no bounds, then mastering Godot 4 and its Path3D capabilities is just the beginning. Embrace this journey, where every challenge is an opportunity to grow and every creation brings you closer to realizing your game design dreams. Let the interactive and dynamic movement unlocked by Godot 4’s paths take your projects to new, uncharted realms of possibility!

At Zenva, we stand ready to be your compass in the vast sea of coding and game creation. Our Godot Game Development Mini-Degree is more than just a course; it’s your gateway to becoming the game developer you’ve always aspired to be. Join us, and let’s turn the potential of your vision into the reality of immersive gaming experiences!

Python Blog Image

FINAL DAYS: Unlock coding courses in Unity, Godot, Unreal, Python and more.