A lot has changed in Godot 4. From rendering to the GD script. And this post is for those who are looking for a Godot 4 2D top-down character controller.
We can create a 2D character controller using the new Godot 4
CharacterBody2D node. It is a 2D physics body node specialized for the characters moved by script.
We will start by creating a separate scene for our player character. This step is optional but follow along for the sake of this tutorial.
Create a new scene
Change your viewport to 2D mode and click the plus icon located on top of your viewport to create a new scene.
Or you can right-click in the File System and then click on Create a new scene.
Add a root node to the scene
Now that we have our empty scene we have to add a root node to it. We will add the
CharacterBody2D node as the root node of our player scene. To add a root node click the plus icon on the top left corner of the scene tab.
This will open a Create New Node window. Here search for the name of the node that you want to add. We are searching for the
CharacterBody2D node so will type it in the search bar, Once you find the node select it and click the create button or double-click the node to create it.
Let’s rename it by right-clicking on the node and selecting rename. I will name it “PlayerCharacter”. We can also add a sprite to our player character by adding a
Sprite2D node as a child.
Add the CollisionShape2D node to the PlayerBody2D
As you have noticed that there is a yellow triangle on the
PlayerBody2D node. This is because the
PlayerBody2D node requires a
CollisionShape2D node as a child.
Right-click on the
PlayerBody2D node and click on the add a child node Now search for the
CollisionShape2D and hit create.
As you can see
CollisionShape2D node is also showing the yellow triangle. This means it needs a shape.
To add a shape
- select the
- in the inspector and click the down arrow on the Shape property
- A list of possible shapes to add should open
- Select the shape that fits your character
I will select the rectangle shape 2D.
Add Script to the node
Here’s how to add the script to the node
- Right-click on node
- Now click the Attach Script option on the right-click menu
- An Attach Node Script window should open
- In this window select the path and name of the script
- And click the Create button
We will name our script “player_character” and hit the create button.
Create Input Map
Now we need to create an Input map for our game. we will use this Input Map to get input for our game from many input devices. To make an input map click the Project option in the top left menu and then Project Settings
Once the Project Settings window popup
- click on the Input Map tab
- Add a name for your new action and hit
- Now in the actions list click the plus icon on your action
- There you can map your input keys
Write a 2D top-down player controller in GDScript
Once we set up the essential nodes and Input Map we can start writing the player controller script.
Add the below code to the player controller script.
In the above code, we are inheriting from the
CharacterBody2D class to use its methods.
Now let’s add some logic to it
@export var player_speed = 100
var direction = Vector2(
Input.get_action_strength("right") - Input.get_action_strength("left"),
Input.get_action_strength("down") - Input.get_action_strength("up")
direction = direction.normalized()
velocity = direction * player_speed
Wow! That’s a lot of code. Let’s understand it line by line. First, we are exporting the
player_speed variable so that we can edit it in the inspector.
Notice that the export syntax is different in Godot 4 from Godot 3
_process(delta) method is from the Godot engine. It is called every frame. We are using it so that we can update the player’s position in every frame. Here delta is the amount of time elapsed during one frame.
Next, we are taking the player input as
Vector2 and storing it in the
We use the
Input.get_action_strength() method to get the input from the action map.
x-axis, we are subtracting the left direction from the right direction. This way if the player presses left then the value will be -1 and player presses the right then the value will be 1
We are doing the same on
the y-axis. The only difference is that we are subtracting the up direction from the down direction. Remember Godot’s
y-axis is upside down.
In the next line, we are normalizing the direction so the magnitude remains at 1.
Now we are assigning the
velocity by multiplying the
direction vector by the
velocity is part of the
CharacterBody2D class that we have extended.
Next up we are calling the
move_and_slide() method of the
CharacterBody2D class. As you have already noticed that it does not need any arguments.
This is different from Godot 3 which requires arguments.
In Godot 4 the
move_and_slide() method uses the
velocity parameter internally.
There you have it. With that said this article ends here.