PhysicsBody2D in Godot – Complete Guide

Physics and motion are key elements in many 2D games, adding a layer of realism and interaction that can greatly enhance the player’s experience. From the way a character jumps and falls back to the ground, to how a ball bounces off the walls in a game of pong, physics plays a crucial role. Understanding the principles of 2D physics in game development allows creators to implement more engaging and dynamic game mechanics. Let’s dive into the exciting world of 2D physics with Godot’s PhysicsBody2D class!

What is PhysicsBody2D?

PhysicsBody2D is an essential class in the Godot Engine, particularly for dealing with the 2D gaming space. It serves as an abstract base class for 2D game objects that interact with physics. This means that it’s not used directly in your games, but instead, it provides the common functionality for other physics-related nodes like RigidBody2D, StaticBody2D, and CharacterBody2D.

What is it for?

The PhysicsBody2D class is foundational for creating objects that can collide with others, respond to gravitational forces, or be controlled through various physical interactions. Whether you’re creating a platformer, puzzle, or any kind of game where physics plays a part, understanding how to use PhysicsBody2D and its inheritors is crucial.

Why Should I Learn About PhysicsBody2D?

For aspiring game developers and seasoned coders alike, acquiring knowledge about PhysicsBody2D is a stepping stone to building more complex and interactive gaming worlds. Learning about this class allows you to:

– Create realistic movement and collision systems for your game’s characters and objects.
– Take advantage of Godot’s built-in physics engine, optimizing your development process.
– Expand upon simple mechanics to create more advanced gameplay elements, such as custom gravity, friction or buoyancy effects.

Embracing the power of PhysicsBody2D opens up a playground of possibilities, where the virtual rules of your game world are yours to define. Let’s begin our journey into the physics of 2D game development with the first section of coding examples!

CTA Small Image

Getting Started with StaticBody2D

StaticBody2D nodes are perfect for objects that don’t need to move or be affected by physics, like walls, platforms, or obstacles. They still interact with other physics bodies and can receive collision callbacks.

To add a StaticBody2D to your scene, use the following code:

var static_body =

You’ll often want to define a shape for your static body to define its collision boundaries. Adding a collision shape is straightforward:

var collision_shape =
collision_shape.shape =
collision_shape.shape.extents = Vector2(50, 5)

With the collision shape set, you can place the static body in your game world:

static_body.position = Vector2(400, 300)

Remember to also set the layer and mask properties to ensure it collides with the intended objects:

static_body.collision_layer = 1
static_body.collision_mask = 1

Integrating RigidBody2D

RigidBody2D nodes are used for objects that are meant to be affected by physics forces, velocity, and impulses. They are perfect to simulate realistic physics behavior, such as falling objects.

To create a RigidBody2D, use:

var rigid_body =

Likewise, add a shape to your rigid body:

var rigid_shape =
rigid_shape.shape =
rigid_shape.shape.radius = 20

Setting the object’s properties allows you to control the physics behavior:

rigid_body.mass = 2
rigid_body.friction = 0.6
rigid_body.bounce = 0.5
rigid_body.gravity_scale = 1

To apply forces or impulses to move the RigidBody2D, you can use methods like `apply_impulse` or `add_force`:

var impulse_vector = Vector2(10, -20)
rigid_body.apply_impulse(Vector2.ZERO, impulse_vector)

Controlling KinematicBody2D

The KinematicBody2D node is designed for objects that are controlled via code, such as player characters. They are not affected by physics unless programmed to do so, which gives you greater control over their movement.

Creating a KinematicBody2D and setting up a collision shape is similar to the other physics bodies:

var kinematic_body =

var kinematic_shape =
kinematic_shape.shape =
kinematic_shape.shape.height = 40
kinematic_shape.shape.radius = 15

To move a KinematicBody2D, use the `move_and_slide` method with the velocity you desire:

var velocity = Vector2(100, 0)

For more complex behaviors, like jumping, you’d handle the physics calculations yourself:

if Input.is_action_pressed("ui_up"):
    velocity.y -= 10
velocity.y += GRAVITY * delta
kinematic_body.move_and_slide(velocity, Vector2.UP)

Handling Collisions

Collisions are the cornerstone of game interactivity. When a PhysicsBody2D object collides with another, Godot provides a way to handle the event.

For a StaticBody2D, you might handle a collision with a signal:

static_body.connect("body_entered", self, "_on_StaticBody2D_body_entered")
func _on_StaticBody2D_body_entered(body):
    print("Collision with static body detected!")

For a RigidBody2D, you might check collision in the `_integrate_forces` callback:

func _integrate_forces(state):
    var collision_count = state.get_contact_count()
    for i in range(collision_count):
        var collided_body = state.get_contact_collider_object(i)
        if collided_body:
            print("Rigid body has collided with ",

KinematicBody2D uses a different approach. After moving, you can check for collisions:

var collision = kinematic_body.move_and_collide(velocity)
if collision:
    print("Kinematic body collided with ",

Remember that each physics body type in Godot provides a unique set of functionalities and is utilized according to the game’s specific requirements. Mastering how to leverage these types will go a long way in supporting the creation of engaging and dynamic games. Stay tuned for the upcoming sections where we harness these skills into practical examples!As we dive deeper into the mechanics of PhysicsBody2D, let’s explore how to customize physics behaviors, interact with signals, and efficiently debug our physics implementations.

Customizing Physics Behaviors

Adjusting the physics properties can vastly change how objects interact within your game. For example, damping can simulate resistance, reducing the object’s velocity over time. Here’s how we apply linear and angular damping to a RigidBody2D for a smoother stopping effect:

rigid_body.linear_damp = 0.5
rigid_body.angular_damp = 0.5

Layers and masks determine what objects will collide. By setting them, we can create intricate collision dynamics. Let’s make sure our RigidBody2D only collides with layer 2 objects:

rigid_body.collision_mask = 2

In some scenarios, applying a constant force or acceleration can lead to interesting gameplay. To achieve this, we might simulate a wind effect or constant horizontal force like so:

func _physics_process(delta):
    var constant_force = Vector2(10, 0)

Interacting with Signals

Signals are Godot’s way of handling events. Let’s say we want to execute code when our RigidBody2D starts or stops contacting another body:

rigid_body.connect("body_entered", self, "_on_body_entered")
rigid_body.connect("body_exited", self, "_on_body_exited")

func _on_body_entered(body):
    print("Rigid body has made contact with",

func _on_body_exited(body):
    print("Rigid body has lost contact with",

Raycasting for Collision Detection

Beyond physical collisions, sometimes we want to detect potential collisions before they happen, or in a non-physical context. RayCast2D nodes can be used for this. Here’s an example where we check if a RayCast2D collides with anything in front of our KinematicBody2D character:

var ray_cast =
ray_cast.cast_to = Vector2(100, 0) # Cast a ray to the right for 100 pixels

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

Debugging Physics in Godot

Godot provides tools to help debug physics-related issues in games. To see collision shapes during gameplay, which is critical when fine-tuning collisions, enable the “Visible Collision Shapes” option in the Debug menu.

To show how changing this setting can help, let’s modify one of our previous examples:

func _ready():
    # This makes the collision shape visible during gameplay
    Engine.debug_collision_shapes = true
    # Rest of the setup code...

If you need to adjust how the physics engine works overall, you can change global settings such as the gravity value or the physics FPS (frames per second), like so:

ProjectSettings.set_setting("physics/2d/default_gravity_value", 400)
ProjectSettings.set_setting("physics/2d/physics_fps", 90)

Using these techniques and tools, you can create a rich physical environment, allowing players to experience a game that feels robust and responsive. Whether dealing with the subtleties of friction and damping, responding to collisions, or debugging the occasionally unexpected physics behavior, Godot’s PhysicsBody2D class and its derivatives offer an array of options for bringing your game to life. Keep practicing and experimenting with different physics settings and observe how they affect your game to become proficient in the art of 2D game physics.Building upon our understanding of PhysicsBody2D and its utility in the Godot engine, we can further enhance our game dynamics with advanced collision detection mechanisms, physics layers, and group-based logic. Here are more ways to implement Godot’s 2D physics with code examples that bring these concepts to life.

**Applying Forces and Torque**
Sometimes, you might want to rotate your objects using physics, for that we can apply torque to a RigidBody2D:

func _process(delta):
    if Input.is_action_pressed("ui_right"):
    elif Input.is_action_pressed("ui_left"):

**Custom Gravity for Specific Objects**
To make an object in your game feel like it’s from another planet, you can assign custom gravity to a RigidBody2D:

rigid_body.gravity_scale = 0.5 # Reduced gravity for this object

This scales the global gravity defined in the project settings just for this object.

**Group-based Collision Logic**
With the use of layers and groups, you can add objects to specific groups and detect collisions with those groups. This is particularly useful for different types of objects, like enemies or collectible items:

# Add a node to a group named “enemies”

# Detect collision with a group within the physics process
func _physics_process(delta):
    var colliding_bodies = get_colliding_bodies()
    for body in colliding_bodies:
        if body.is_in_group("enemies"):
            print("Collided with enemy:",

**Linear and Angular Velocity**
Setting the linear and angular velocity of a RigidBody2D allows us to move and spin the object with precision:

rigid_body.linear_velocity = Vector2(100, 0) # Move right at a constant speed
rigid_body.angular_velocity = 2 # Spin at a constant angular velocity

**One-way Collision Platforms**
Creating platforms that can be jumped upon from below and stood on is a common requirement in platformer games. Godot’s StaticBody2D and CollisionShape2D combination allows for this:

var one_way_collision_shape =
one_way_collision_shape.shape =
one_way_collision_shape.shape.extents = Vector2(100, 5)
one_way_collision_shape.set_collision_layer_bit(0, true)
one_way_collision_shape.set_collision_mask_bit(1, true)
one_way_collision_shape.one_way_collision = true

**Setting Up Collision Layers Programmatically**
Defining collision layers and masks through code enhances collision interaction flexibly. It’s useful for procedurally generated games or games that dynamically change which layers objects interact with:

kinematic_body.collision_layer = 1 << 2 # Set to layer 3
kinematic_body.collision_mask = 1 << 1 # Will only collide with layer 2

These examples illustrate how Godot’s PhysicsBody2D can be used for a wide variety of game mechanics. By now you should have a fair grasp of movement, collision detection, and the manipulation of physics properties for different gameplay scenarios.

Always keep experimenting with these properties to see how they can create the game physics you envision. Remember, in game development, there’s often more than one way to achieve the desired outcome. Enjoy the discovery process as you build your games, and don’t shy away from trying unconventional physics simulations – they could lead to the next big gameplay innovation.

Continue Your Game Development Journey

Mastering 2D physics in Godot is just the beginning of your game development adventure! To keep expanding your skills and dive deeper into the world of game creation with Godot, we encourage you to check out our Godot Game Development Mini-Degree. This comprehensive program is designed to take you from the fundamentals to more complex game development topics across a range of genres, helping you to build a diverse portfolio of cross-platform games.

Within the Mini-Degree, you’ll explore crucial aspects of game development such as character control, UI systems, and a variety of game mechanics from RPGs to RTSs and beyond. These courses are crafted to be accessible and flexible, ensuring you can learn at your own pace on any device. After completing the Mini-Degree, you’ll have a solid foundation in both 2D and 3D game development using the Godot engine, preparing you for a successful career in this exciting field.

For those seeking a broader selection of Godot tutorials, visit our full collection of Godot courses at Zenva Academy. Whether you are just starting out or looking to advance your existing skills, our courses offer a diverse learning experience to help boost your career and bring your game development ideas to life. Continue learning, keep coding, and don’t forget that with Zenva, you can go from beginner to professional in your own development journey.


Embarking on the path of game development is a voyage of endless creativity and learning. By understanding and utilizing Godot’s 2D physics with PhysicsBody2D, you’re equipping yourself with the tools to bring your most imaginative game ideas to life. Keep exploring the possibilities, testing the limits of what you can create, and always strive for that perfect balance between fun gameplay and realistic physics.

Whether you’re just getting started or aiming to level up your game development skills, remember that our Godot Game Development Mini-Degree is here to guide you every step of the way. From your first script to your first game launch, Zenva Academy is excited to be a part of your journey. Let’s continue creating and learning together – the game universe is waiting for your next great adventure!

Python Blog Image

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