Curve3D in Godot – Complete Guide

In the vast expanse of game development and digital creation, mastering the intricacies of code and design can be akin to navigating a labyrinth. However, like a beacon of light, understanding the use of tools and classes within your chosen game engine can guide you through the darkness and bring your imaginative worlds to life. One such tool in the Godot 4 game engine is the Curve3D class, a powerful ally in sculpting the undulating paths that characters and objects may traverse within your 3D space.

What is Curve3D?
Curve3D, as documented in Godot 4’s arsenal, is an embodiment of the mathematical concept of a Bézier curve, but brought into the three-dimensional realm. For those venturing into digital creation, this may seem daunting at first glance, but fear not! The essence of Curve3D is simple: it is a path defined by points and the mathematical relationships between them, allowing for the creation of smooth and controllable lines through 3D space.

What is Curve3D Used For?

Primarily, Curve3D gives shape to Godot’s Path3D node. Imagine the soaring arc of a roller coaster or the graceful flight path of a bird—all these can be described using Curve3D. It isn’t limited to grand movements, either. This class can be of service in any scenario where a defined, adjustable trajectory needs to be plotted, from guiding projectiles to animating UI elements moving in a 3D space.

Why Should I Learn Curve3D?

Within the domain of game development, the capacity to craft natural movements and trajectories stands as a pillar of immersive gameplay. By conquering the Curve3D class, you arm yourself with the ability to enrich your environments with dynamic paths and motions, which not only captivate your audience but also streamline your development process with precise, easy-to-adjust pathways. Learning Curve3D primes you for a deeper understanding of spatial mechanics in Godot, thus broadening the scope of what you can build, animate, and innovate.

CTA Small Image

Getting Started with Curve3D

To begin our journey with Curve3D, we need to familiarize ourselves with creating a path within Godot. Let’s start by creating a simple Curve3D and attaching it to a Path3D node.

var my_curve =
var path =
path.curve = my_curve

In this snippet, we initialize a new instance of Curve3D and a Path3D node. We then set the Path3D’s curve property to our newly created Curve3D object before adding the path as a child to the current scene.

Adding Points to Curve3D

Points on a Curve3D define the trajectory of the path. Let’s add points to our curve using the `add_point` method, which takes the position of the point in 3D space, and optionally, the in and out direction handles (for Bézier curves).

my_curve.add_point(Vector3(0, 0, 0))
my_curve.add_point(Vector3(0, 5, 5), Vector3(-1, 0, 0), Vector3(1, 0, 0))
my_curve.add_point(Vector3(0, 10, 10))

Here, we’ve added three points to our curve. The second point is defined with in and out direction handles to control the curve’s entry and exit point tangents, influencing the curvature at this point.

Editing and Removing Points

Let’s explore how we can modify the properties of these points after their creation. Perhaps we want to adjust a point’s position or its handles; we can do this with the `set_point_position` and `set_point_in`/`set_point_out` methods.

my_curve.set_point_position(1, Vector3(0, 5, 10))
my_curve.set_point_in(1, Vector3(-2, 0, 0))
my_curve.set_point_out(1, Vector3(2, 0, 0))

What if a point is no longer needed? Erasing it is just as straightforward:


Be cautious; removing points changes the indices of subsequent points in the curve!

Visualizing the Curve3D

Godot’s editor provides a real-time view of your Curve3D in the viewport. But when running the game, how can we visualize it? Let’s create a simple mesh along the curve using CSGPolygon nodes.

var csg_polygon =
csg_polygon.curve = my_curve
csg_polygon.polygon = PoolVector2Array([Vector2(0, 0.5), Vector2(1, 0.5), Vector2(1, -0.5), Vector2(0, -0.5)])
csg_polygon.mode = CSGPolygon.MODE_PATH

In this snippet, a CSGPolygon node uses our Curve3D for its path, and we define the polygon shape to extrude along it. The MODE_PATH mode indicates the shape should follow the curve.

With this foundation, you’re well on your way to understanding and utilizing Curve3D in your projects. We will continue to build upon these concepts in the next part of our tutorial, bringing motion and interactivity to our paths. Stay tuned!As we dive deeper into the functionalities of the Curve3D class, it’s crucial to understand how this tool can be harnessed to animate objects along the path we’ve defined. Let’s explore how to make a 3D model follow the trajectory set by our Curve3D.

Animating Objects along Curve3D

To animate an object along the path, we first need to attach it to a PathFollow3D node. This special node automatically updates its position and rotation according to its offset along the curve.

var follow =
follow.curve = my_curve
var my_model = load("res://my_model.tscn").instance()

Here, `my_model` represents the 3D model you want to animate along the path. We create a PathFollow3D node, set its curve to our previously defined Curve3D, and add the 3D model as a child to it. The last step is adding our PathFollow3D as a child to the Path3D.

Now, to move the object along the path:

follow.offset += delta * speed

By adjusting the `offset` property, you control where along the curve your object is. Incrementing it moves the object, and `delta * speed` ensures that this movement is smooth and time-based.

Accessing Curve Information

Sometimes you need to know more about the curve itself. Godot offers a variety of methods to access this data:

// Get the number of points
var point_count = my_curve.get_point_count()

// Get a point's position by index
var point_position = my_curve.get_point_position(0)

// Get the total length of the curve
var curve_length = my_curve.get_baked_length()

These methods allow you to dynamically adjust your curve or retrieve information necessary for gameplay mechanics, such as spawning objects at certain points along the path.

Adjusting the Curve Resolution

The resolution of your curve refers to how many points exist between the points you’ve explicitly defined. A higher resolution means a smoother curve but at the cost of performance.

my_curve.bake_interval = 0.1

The `bake_interval` property defines the distance between the baked points. A smaller value results in a more detailed curve.

Interacting with the Curve in Real Time

Game development is all about interactivity. You can not only create and edit Curve3D at design time, but also modify it during gameplay. Here’s how you might dynamically adjust a curve based on player input:

if Input.is_action_just_pressed("curve_up"):
   my_curve.set_point_position(1, my_curve.get_point_position(1) + Vector3(0, 1, 0))

In this example, pressing a button (assigned to the “curve_up” action in Godot’s Input Map) would elevate the second point of the curve in real-time.

Combining Curves

Combining different Curve3D instances can be a powerful way to create complex paths:

var my_second_curve =
// Define second curve points...


Using the `append` method, Curve3D can connect with another curve, extending the path without creating a new node.

With these examples, you should have a solid foundation for using Curve3D to create dynamic and engaging 3D paths in Godot. Whether for guiding a character through an enchanted forest or plotting the flight of a spaceship, Curve3D unlocks the potential for richly detailed and interactive game environments. Keep experimenting with its features to achieve the perfect motion and flow for your game elements.Animating objects and manipulating paths dynamically can bring a whole new level of life to your Godot games. This is where tapping into the signal system of Godot becomes beneficial. For instance, if you want to trigger an event when an object reaches the end of a path, you might connect a signal from the `PathFollow3D` node like so:

follow.connect("path_finished", self, "_on_path_finished")

And then, define the callback:

func _on_path_finished():
    print("The object has reached the end of the path.")

Utilizing C# for Curve3D
If you’re working in C# within Godot, interacting with a `Curve3D` object would look like this:

// Create a new Curve3D object
Curve3D myCurve = new Curve3D();

// Add points to the curve
myCurve.AddPoint(new Vector3(0, 0, 0));
myCurve.AddPoint(new Vector3(0, 5, 10), new Vector3(-1, 0, 0), new Vector3(1, 0, 0));

// Accessing point positions
Vector3 pointPosition = myCurve.GetPointPosition(1);

// Adjusting the curve resolution
myCurve.BakeInterval = 0.05f;

These examples demonstrate how equivalent functionality is accessed through C# syntax as opposed to GDScript.

Interpolating Along the Curve
Getting a point on the curve that doesn’t correspond to one of your control points is another common requirement. For this, we use the `interpolate()` method, which could be used to find a position at a certain percentage along the total length of the curve:

var t = 0.5  // Halfway along the curve
var point_on_curve = my_curve.interpolate(t)

This method can be particularly useful for moving objects at a variable speed or spacing particles along a pathway.

Adjusting Curve Tilt
Sometimes, merely adjusting the position isn’t enough; you may want to alter the ’tilt’ of the curve, which affects how an object rotates around the curve’s axis as it follows the path:

my_curve.set_point_tilt(1, math.radians(45))

This example applies a 45-degree tilt to the second point on the curve, which could be applied to banking turns on a racetrack, or simulating the roll of a spaceship.

Looping Your Path
Creating a looped path for continuous movement is a simple but powerful feature of Curve3D:

my_curve.loop = true

Setting the `loop` property to `true` connects the end of your Curve3D back to the beginning, ensuring that any object following the path will continue in a seamless circuit.

Through these various method implementations and properties, Curve3D in Godot provides a depth of control suitable for a diverse array of game mechanics. Whether it’s the smooth gliding flight of a bird or the twist and turns of a thrilling space chase, the functional diversity of the Curve3D class allows you to craft your vision with precision and creativity. Continue building your knowledge and experimenting with these techniques to enhance the dynamism of your game worlds and bring your unique gameplay experiences to life.

Continue Your Game Development Journey

Embarking on the path of game development can be as thrilling as the games we aspire to create. With the foundation you’ve started to build in using Curve3D within Godot 4, you’re well on your way to bringing your imaginative worlds and dynamic gameplay to life. We encourage you to keep the momentum going and further your skills. With a vast and vibrant realm of knowledge waiting to be discovered, the journey is as rewarding as the destination.

As your next step, we invite you to explore our Godot Game Development Mini-Degree, a carefully tailored curriculum that continues to empower creators with the knowledge and tools to craft stunning cross-platform games. Our comprehensive courses take you from the fundamental components of game development to implementing advanced features that will set your projects apart. And if you’re keen to expand your Godot repertoire, you’ll find a wide-ranging collection of courses in our Godot course library, designed to match your passion with practical expertise.

Whether you’re just starting or looking to level up, our courses are structured to accommodate your learning pace, ensuring that you can balance your educational endeavors with your personal commitments. With Zenva, transform knowledge into tangible skills that can open doors to opportunities in the ever-expanding game market. Embrace the adventure ahead and let your creative spirit soar. The world of game development awaits you.


In conclusion, mastering the Curve3D class in Godot 4 can significantly elevate the interactive landscape of your games, enriching your digital terrains with the aesthetic vibrancy and organic fluidity that keep players engrossed. Your journey into game development is one of infinite creativity – every line of code, every curve, and every game mechanic you design is a step forward in honing your craft. Let this be just the beginning of many more ambitious projects that await you in the realm of game creation.

Remember, at Zenva, we’re here to guide you each step of the way. The skills you’ve begun to develop today pave the way for tomorrow’s successes. Continue creating, learning, and expanding your horizons with our Godot Game Development Mini-Degree. Transform your game development dreams into a virtual reality that enthralls and entertains. Your potential is boundless; let’s unlock it together!

Python Blog Image

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