RayCast2D in Godot – Complete Guide

Raycasting is a fundamental concept in game development used for many types of gameplay mechanics, like line-of-sight detection, shooting lasers, throwing spears, and even determining where an object should land after being thrown. As developers, understanding how to implement raycasting can open up endless possibilities for creating interactive and responsive environments. In Godot 4, a powerful and user-friendly game engine, this concept is encapsulated within the RayCast2D node.

What is RayCast2D?

RayCast2D is a node in Godot 4 designed to represent a ray from its origin to its target position. It’s used to detect and return the first CollisionObject2D that it intersects with in 2D space. This tool is not only important but incredibly versatile, enabling us to construct complex interactions simply and efficiently in a two-dimensional setting.

What is RayCast2D Used For?

RayCast2D finds its use in a wide array of scenarios within a 2D environment. From detecting obstacles in a character’s path to confirming line-of-sight for AI or simply solving puzzles, it serves as a foundational feature for robust and dynamic game mechanics.

Why Should I Learn About RayCast2D?

Learning about RayCast2D not only helps you improve collisions in your game but also aids in creating more immersive and intelligent gameplay. With raycasting, you can add depth to your game’s mechanics making the experience for the player rich and full of surprises. Moreover, understanding and mastering RayCast2D can significantly improve the quality and performance of your game, providing smooth interactions and an overall polished feel.

Join us as we delve into the functions and features of RayCast2D through a variety of examples, giving you a solid understanding of how to implement this potent feature in your next Godot 4 project!

CTA Small Image

Enabling and Configuring RayCast2D

Before you can use RayCast2D, you need to add it to your scene tree and configure it. Here’s how you add a RayCast2D node as a child to your player node:

const RayCast2D = preload("res://path_to_your_RayCast2D_scene.tscn")

func _ready():
    var ray_cast = RayCast2D.instance()

Next, let’s set the properties of the ray. We’ll define the length of the ray and ensure it is set to Enabled so it can detect collisions.

var ray_cast = RayCast2D.new()
ray_cast.cast_to = Vector2(100, 0)    # Ray cast 100 pixels to the right
ray_cast.enabled = true               # Enable ray casting

func _ready():

Don’t forget to manually enable the raycasting in the Godot editor since it’s not enabled by default.

Checking for Collisions

After configuring the ray, you can check if it has collided with anything. Use the is_colliding() function to check for collisions and get_collider() to retrieve the collided object:

func _physics_process(delta):
    if ray_cast.is_colliding():
        var collider = ray_cast.get_collider()
        print("Collided with: ", collider.name)

With the information about what the ray has collided with, you can trigger different reactions based on the type of object. For example, if the collider has a specific method to interact with, you can call it:

if ray_cast.is_colliding():
    var collider = ray_cast.get_collider()
    if collider.has_method("apply_damage"):

Adjusting the Ray’s Collision Mask

Often, you’ll want your ray to only detect certain types of objects. In Godot, each layer of the CollisionLayer can represent different types of objects. You can specify the collision mask of the ray so that it only collides with certain layers:

ray_cast.collision_mask = 1 # The ray only collides with objects in layer 1

Alternatively, if you wish to check for multiple layers, you can use a bitwise OR operation to include them:

ray_cast.collision_mask = 1 | 4 # The ray collides with objects in layers 1 and 4

Interacting with Detected Objects

Now that you know how to detect collisions, it’s essential to learn how to interact with the detected objects. For instance, you might want to collect an item when a player’s ray hits it or open a door when a button is pressed:

if ray_cast.is_colliding():
    var collider = ray_cast.get_collider()
    if collider.is_in_group("collectible"):
        collider.queue_free() # Removes collectible from the scene
        # Implement your collection logic here
    elif collider.is_in_group("door"):
        collider.open() # Calls the 'open' function on the door node

These snippets set the groundwork for implementing RayCast2D in Godot 4. Keep iterating on these examples, and you’ll be well on your way to creating engaging mechanics with raycasting in your games. In the next sections, we will dive into more advanced usage and how to leverage RayCast2D for complex scenarios such as terrain checking and AI sight lines.

Expanding on the previous foundation, there are more intricate ways to utilize RayCast2D in Godot 4. Here are additional implementations to enrich your game’s mechanics:

To adjust the length of the ray at runtime, perhaps to simulate a character extending their arm or a flashlight with variable reach, the following example dynamically sets the cast_to property:

func _process(delta):
    if Input.is_action_just_pressed("extend_arm"):
        ray_cast.cast_to.x += 50       # Extends the ray length by 50 pixels
    elif Input.is_action_just_pressed("retract_arm"):
        ray_cast.cast_to.x -= 50       # Retracts the ray length by 50 pixels

Sometimes you may want to cast a ray in the direction the character is facing. This requires determining the direction and updating the cast_to coordinate accordingly:

var direction = 1 # Right by default. -1 for left.

func _physics_process(delta):
    ray_cast.cast_to = Vector2(100 * direction, 0) # Update direction based on character orientation

You can also check for multiple collisions along a ray’s path by using the get_colliders() method, which returns an array of detected objects:

func _physics_process(delta):
    var collisions = ray_cast.get_colliders()
    for collider in collisions:
        print("Collided with: ", collider.name)

If your game requires precision, you may need to get the exact collision point of the ray. Godot provides a method called get_collision_point() to accomplish this:

if ray_cast.is_colliding():
    var collision_point = ray_cast.get_collision_point()
    print("Collision Point: ", collision_point)

For more complex raycasting, such as creating a laser that bounces off mirrors, you can use the collision normal to calculate the reflection vector:

if ray_cast.is_colliding():
    var collision_normal = ray_cast.get_collision_normal()
    var bounce_direction = direction - 2 * direction.dot(collision_normal) * collision_normal
    # Here, you would use bounce_direction for the next segment of the laser

In addition to 2D gameplay, raycasting can be utilized for UI elements as well. For instance, detecting UI button presses without using the buttons’ signals:

func _unhandled_input(event):
    if event is InputEventMouseButton and event.pressed:
        ray_cast.cast_to = get_global_mouse_position() - ray_cast.global_position
        if ray_cast.is_colliding():
            var collider = ray_cast.get_collider()
            if collider is Button:
                collider.emit_signal("pressed")  # Manually emit the button's signal

Lastly, you can convert the RayCast2D to a line drawing for visual debugging or laser effects. This code would work inside a draw() function or by updating a Line2D’s points:

override func _draw():
    if ray_cast.is_colliding():
        draw_line(ray_cast.global_position, ray_cast.get_collision_point(), Color.red)
        draw_line(ray_cast.global_position, ray_cast.global_position + ray_cast.cast_to, Color.green)

These examples highlight the adaptability of RayCast2D in Godot 4, offering numerous possibilities for gameplay mechanics and interactions. Whether it’s extending the player’s reach, creating lasers that bounce around, or drawing rays for visual effects, mastering raycasting is a powerful asset in any game developer’s toolkit. Keep practicing and experimenting with these techniques, and you’ll soon be able to craft more intricate and engaging experiences in your game projects with confidence.

Godot’s RayCast2D can also be used for AI perception, where NPCs can detect if the player is within their field of view. Here’s an example of how you might set this up:

var fov = 45.0  # Field of view in degrees

func _process(delta):
    var player_position = get_player_position()  # You would implement this
    var to_player = (player_position - global_position).normalized()

    # Check if within field of view
    if Vector2(1, 0).angle_to(to_player) <= deg2rad(fov / 2):
        ray_cast.cast_to = to_player * 100  # Set ray distance
        if ray_cast.is_colliding():
            var collider = ray_cast.get_collider()
            if collider.is_player():       # You would implement this
                print("Player spotted!")

For platformer games or any genre requiring terrain analysis, RayCast2D can check for ground beneath characters or enemies to help with fall detection and platform snapping:

const RAY_LENGTH = 50  # Length of the ray to cast downwards

func _process(delta):
    ray_cast.cast_to = Vector2(0, RAY_LENGTH)
    if ray_cast.is_colliding():
        var collision_point = ray_cast.get_collision_point()
        global_position.y = collision_point.y  # Snap to ground
        print("No ground beneath")

Triggering traps when a character walks past a certain point can create dynamic challenges:

func _physics_process(delta):
    if ray_cast.is_colliding():
        var collider = ray_cast.get_collider()

        if collider.is_character():   # You would implement this
            activate_trap()           # You would implement this

In games where stealth is a feature, using RayCast2D for visibility checks is common. Here is how you could handle hiding mechanics:

func _process(delta):
    if ray_cast.is_colliding():
        var collider = ray_cast.get_collider()
        if collider.is_hiding_spot():  # Check if the player is colliding with a hiding spot
            hide_player()   # You would implement this

Pathfinding is a common use case for raycasting. You can use multiple RayCast2D nodes to simulate a “vision cone,” detecting obstacles in various directions. This helps in adjusting the NPC pathfinding algorithms based on seen obstacles:

var left_ray = $LeftRayCast
var right_ray = $RightRayCast

func _process(delta):
    left_ray.cast_to = Vector2(-100, 0)   # Cast to the left
    right_ray.cast_to = Vector2(100, 0)   # Cast to the right
    var collisions = []
    if left_ray.is_colliding():
    if right_ray.is_colliding():
    adjust_path(collisions)  # You would implement this

Finally, RayCast2D can be extended to create custom sensors for detecting when a player enters a dangerous area, commonly used in puzzle and adventure games:

func _physics_process(delta):
    if ray_cast.is_colliding():
        var collider = ray_cast.get_collider()
        if collider.is_player():   # Check if it's the player that has been detected
            notify_player_of_danger()  # You would implement this

Through the use of these examples, you can see how versatile RayCast2D is and how it can be applied to create more engaging game mechanics. By leveraging raycasting effectively, you can enhance the player’s experience with more immersive, interactive, and responsive gameplay elements. Continue to experiment with RayCast2D, and the depths of what you can achieve are only limited by your imagination.

Where to Go Next in Your Game Development Journey

After diving into the world of RayCast2D with Godot 4, you might be wondering what the next step is. It’s important to continue learning and honing your skills to bring your game ideas to life. To further your game development education, we highly recommend exploring our Godot Game Development Mini-Degree. This comprehensive collection of courses is designed to equip you with the knowledge to build your own games from scratch using the Godot 4 engine. From mastering 2D and 3D assets to understanding gameplay control flows and mechanics across various game genres, our mini-degree has got you covered.

Whether you’re a beginner or you’re looking to solidify your existing knowledge, our project-based courses offer the flexibility and practical experience you need to succeed. As you progress through the different levels, you’ll create tangible examples of your growing expertise. Plus, with our curriculum, you’re joining a community of over 1 million learners and developers, many of whom have used their skills to publish games and advance their careers.

Looking for a broader range of Godot topics? Check out our full selection of Godot courses at Zenva Academy to find content that fits your interests and goals. With over 250 courses, your journey from beginner to professional is just a few clicks away. Dive deep into the flexibility and power of Godot, and start building the game of your dreams today!


Embracing the power of RayCast2D in Godot 4 is just the start of a thrilling game development journey. We’ve only scratched the surface of what can be achieved with this versatile tool. By implementing raycasting in your projects, you’re laying the groundwork for deeper gameplay mechanics, more interactive worlds, and an overall enhanced gaming experience. Remember that every skill you acquire opens the door to new possibilities in the realm of game creation. So, continue to experiment, build, and share your unique visions with the world.

With the guidance of our Godot Game Development Mini-Degree, you’re not just learning—you’re making an investment in your future as a game developer. We’re excited to see what fantastic games you’ll create and we’re here to support you every step of the way. Keep pushing the boundaries, continue crafting compelling stories and gameplay, and let’s take the gaming world by storm together!

Python Blog Image

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