CylinderShape3D in Godot – Complete Guide

Welcome to this detailed tutorial on the `CylinderShape3D` class in Godot Engine 4. Whether you’re just starting out in game development or looking to expand your knowledge of physics collision shapes, this class offers unique functionality that can enhance your game’s interactivity and realism. Dive into the world of 3D shapes and learn how the `CylinderShape3D` can add depth and structure to your virtual worlds.

What is CylinderShape3D?

The `CylinderShape3D` is a type of collision shape in Godot Engine 4, serving as a fundamental component for 3D physics interactions. It’s designed to represent a simple cylinder and can be used with a `CollisionShape3D` node to give physical presence to objects within the game world.

What is it for?

Collision shapes like `CylinderShape3D` are essential for determining the physical boundaries of objects. This allows for more realistic interactions, such as collisions and physics simulations, which are critical in creating immersive gameplay experiences.

Why Should I Learn It?

Understanding collision shapes is a cornerstone of game development, especially when dealing with 3D environments. By mastering the `CylinderShape3D`, you can:

– Accurately simulate real-world physics.
– Design interactive game objects that respond to collisions.
– Control the performance and feel of your game through different collision shapes.

With this guide, we aim to provide you with engaging examples and thorough explanations, enabling you to confidently implement `CylinderShape3D` in your games. Let us embark on a journey through Godot’s collision shapes and unlock the potential of dynamic 3D worlds.

CTA Small Image

Creating a Basic CylinderShape3D

To get started, we will add a `CylinderShape3D` to an object in our scene. First, add a `CollisionShape3D` node to your scene which acts as a container for our collision shape.

var collision_node =

Next, create an instance of `CylinderShape3D` and assign it to the `shape` property of `CollisionShape3D`.

var cylinder_shape =
collision_node.shape = cylinder_shape

This assigns a basic cylinder collision shape to your object, which will interact with other physics bodies and areas in your game scene.

Adjusting Cylinder Dimensions

After creating a `CylinderShape3D`, you may want to adjust its radius and height to fit your object. You can modify these properties directly:

cylinder_shape.radius = 2.0
cylinder_shape.height = 5.0

In this example, the cylinder’s radius has been set to `2` and its height to `5`. These values can be changed to whatever dimensions your object requires.

Positioning and Rotating the Cylinder

Once you have your `CylinderShape3D` set up, you might need to position or rotate it to align properly with your object. This is done by manipulating the collision node’s transform:

collision_node.transform.origin = Vector3(0, 2.5, 0) # This raises the collision shape up

For rotation, you would adjust the transform’s rotation property:

collision_node.transform.basis = Basis().rotated(Vector3(1, 0, 0), Mathf.deg2rad(90))
# The collision shape is now rotated 90 degrees around the X axis

These transformations ensure your collision shape fits your object perfectly in the 3D space of your game.

Visualizing the Cylinder in the Editor

Visualizing collision shapes in the Godot editor can be incredibly helpful for debugging and ensuring they are positioned correctly. By default, Godot provides a visual representation of `CylinderShape3D` when it is selected.

However, if you need to always see the boundary of the shape, even when not selected, you can enable `Visible Collision Shapes` from the `Debug` menu in the Godot editor.

Remember that these visual aids are not visible in the running game; they are solely for development purposes. Here’s how the collision shape might look in the editor when selected:

# No additional code needed, this is just an editor setting

This feature in the editor ensures you do not have to run the game to check if your collision shapes are correct, saving you valuable development time.

Now that we have covered the creation and basic manipulation of `CylinderShape3D`, we’ll move on to more advanced examples in the following section. Stay with us as we dive into how `CylinderShape3D` can be used in conjunction with other nodes and scripts to create dynamic gameplay.Continuing with our exploration of the `CylinderShape3D`, we aim to extend your understanding with practical examples. To enhance the learning experience, we will handle more dynamic scenarios where the `CylinderShape3D` might interact with other objects and simulate specific behaviors.

Responding to Collisions

One common use-case is to detect when our cylinder-shaped object collides with others. This can be set up in the physics process with signal connections or by polling for collisions.

func _physics_process(delta):
    if $CollisionShape3D.is_colliding():
        print("Collision detected!")

In this snippet, we’re checking for collisions in every physics frame. When our shape detects a collision, it prints a message to the console, allowing us to validate the interaction.

Collisions with Specific Objects

We might also want to react only when colliding with specific objects. To achieve this, we give our objects of interest a unique group and then check for collisions with objects in that group.

# Example of setting an object to a unique group

# Example of checking collision with objects in that group
if $CollisionShape3D.is_colliding():
    var colliding_body = $CollisionShape3D.get_collider()
    if colliding_body.is_in_group("target"):
        print("Collision with target object!")

This way, you can build more complex interactions and responses to collisions in your game logic.

Adjusting Collision Layers

Adjusting which collision layer your `CylinderShape3D` is on can determine what it collides with. This can be done through the Godot Editor or with code:

collision_node.collision_layer = 1
collision_node.collision_mask = 1

In this example, we’re setting our `CollisionShape3D` to exist on layer 1 and only collide with objects on layer 1 as well.

Applying Forces to the Cylinder

To illustrate physics interactions, we will apply a force to our object. For this, we need a `RigidBody3D` to work with our `CollisionShape3D`.

# Assume we have a rigid body variable named 'rigid_body'
rigid_body.apply_central_impulse(Vector3(0, 10, 0))

By applying an impulse to the center of our `RigidBody3D`, the object would react as if a force pushed it upwards.

Changing Shape Properties During Runtime

For dynamic gameplay, you may want to change the shape of the `CylinderShape3D` during runtime; for instance, to simulate an object that can change size.

func resize_cylinder(new_radius, new_height):
    cylinder_shape.radius = new_radius
    cylinder_shape.height = new_height

This function adjusts the size of our cylinder to new specified dimensions, offering interesting possibilities such as telescoping mechanics or dynamic barriers.

Each piece of code above serves as an instrumental building block toward creating intricate gameplay mechanics with the `CylinderShape3D`. As we delve deeper, we find that the applications of collision shapes are vast and varied. By blending the technicality of physics with the creativity of gameplay design, `CylinderShape3D` becomes much more than merely a shape—it’s a catalyst for immersive game experiences.Moving forward, we’ll extend the functionality of the `CylinderShape3D` by exploring more complex use cases and integrating it with Godot’s broader systems. Let’s delve into these examples.

Our first scenario involves modifying the `CylinderShape3D` in response to user input. Imagine a game where a character can push objects, and we want the cylinder collision shape to grow in front of the character as they push.

func _process(delta):
    if Input.is_action_just_pressed("push_action"):
        resize_cylinder(cylinder_shape.radius, cylinder_shape.height + 1)

In the above example, when the player activates the push action, the `resize_cylinder` function is called to elongate the cylinder, simulating the pushing force.

Next, let’s focus on an interactive scene where we want an object to roll off a cylinder. We’ll use a `RigidBody3D` combined with a `CylinderShape3D` for the ground and see how other objects interact with it.

func spawn_rolling_object():
    var rolling_body =
    var object_shape =
    var collision_shape =
    collision_shape.shape = object_shape

    rolling_body.transform.origin = Vector3(0, 10, 0) # Start above the cylinder

By adding a `RigidBody3D` with a `SphereShape3D` above the cylinder shape, we allow it to naturally roll off due to gravity and the cylindrical surface.

Moreover, consider a situation where our cylinder-shaped object can scale based on another object’s proximity. You could set up a monitoring system using `Area3D` nodes:

func _ready():
    $ProximityArea.connect("body_entered", self, "_on_body_entered")
    $ProximityArea.connect("body_exited", self, "_on_body_exited")

func _on_body_entered(body):
    if == "Player":
        resize_cylinder(cylinder_shape.radius, cylinder_shape.height * 1.5)

func _on_body_exited(body):
    if == "Player":
        resize_cylinder(cylinder_shape.radius, cylinder_shape.height / 1.5)

Through signals, we detect when the player enters or exits the defined area, adjusting the height of our cylinder accordingly.

Continuing with interactivity, we might want to script a health pickup that players collect by colliding with a `CylinderShape3D`.

func _on_HealthPickup_body_entered(body):
    if body.is_in_group("player"):"increase_health", 10) # Assuming the player has an 'increase_health' method
        queue_free() # Remove the health pickup from the scene

In the code above, once a player enters the collision shape of the health pickup, their health is increased and the pickup is removed.

To further illustrate cylinder interaction, let’s have an object follow a path defined by a series of cylinder checkpoints. We’ll utilize the `PathFollow3D` node for this purpose.

func _process(delta):
    if $PathFollow3D.unit_offset < 1.0:
        $PathFollow3D.unit_offset += delta * 0.1  # Move the following object along the path

This simple implementation progressively moves an object along a predefined path at a consistent speed.

These examples are designed to showcase the wide-ranging applications of the `CylinderShape3D` within Godot Engine. By incorporating user input, physics interactions, proximity scaling, health pickups, and path following, we demonstrate the versatility and potential for engaging gameplay that this collision shape facilitates. Each snippet extends the groundwork laid by the basics and showcases how `CylinderShape3D` can contribute to the richness of your game’s mechanics and player experiences.

Continuing Your Godot Engine Journey

Now that you’ve dipped your toes into the waters of collision shapes with `CylinderShape3D` in Godot Engine 4, it’s time to continue your journey through game development. If you’re keen to build your skills further, our Godot Game Development Mini-Degree provides a structured and thorough learning path. With a curriculum covering everything from GDScript basics to intricate gameplay mechanics, our courses are perfect for anyone looking to deepen their understanding of game development with Godot 4, regardless of prior experience.

For a broader exploration of what we offer, check out our full range of Godot courses. These lessons will guide you through different aspects of game design and development, helping you to create engaging, responsive, and interactive game experiences. By choosing Zenva, you’re not just learning to code; you’re building a foundation that can propel you from a curious beginner to a seasoned game developer. Embrace the journey, and we look forward to seeing the incredible games you’ll create!


As we wrap up our exploration of the `CylinderShape3D` collision shape in Godot Engine 4, we hope you’ve gained an appreciation for the intricacies and possibilities it presents. Remember, understanding collision shapes like `CylinderShape3D` is just the beginning. With each new skill you gain, every obstacle you overcome, you’re crafting the future of your game development journey. Whether enhancing the realism of physical interactions or unleashing your creativity within the digital realm, the tools you’ve learned here will be invaluable.

Are you hungry for more? Continue to expand your skill set, challenge yourself, and bring your game visions to life by diving deeper into our Godot Game Development Mini-Degree. Stay curious, keep learning, and let Zenva be the guiding force in your adventure through game development. Together, let’s build not just games, but worlds of wonder and excitement!

Python Blog Image

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