Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

2D movement overview

Wprowadzenie

Każdy początkujący zadaje sobie pytanie: "Jak poruszać moją postacią?". W zależności od stylu gry, którą tworzysz, możesz mieć specjalne wymagania co do sposobu poruszania się twojej postaci, jednak ogólnie rzecz biorąc ruch w większości gier 2D opiera się na niewielkiej ilości rozwiązań.

We'll use CharacterBody2D for these examples, but the principles will apply to other node types (Area2D, RigidBody2D) as well.

Konfiguracja

Each example below uses the same scene setup. Start with a CharacterBody2D with two children: Sprite2D and CollisionShape2D. You can use the Godot icon ("icon.png") for the Sprite2D's texture or use any other 2D image you have.

Otwórz Projekt -> Ustawienia projektu i wybierz zakładkę "Mapowanie wejścia". Dodaj pokazane na poniższym wycinku akcje wejścia (po więcej szczegółów skocz do InputEvent):

../../_images/movement_inputs.webp

8-mio kierunkowy ruch

W przypadku tego przykładu chcemy, żeby nasz użytkownik poprzez naciskanie czterech klawiszy kierunków (góra/lewo/dół/prawo lub W/A/S/D) mógł poruszać się w wybranych kierunkach. Nazwa "8-mio kierunkowy ruch" bierze się stąd, że gracz może poruszać się na ukos, jeśli przytrzyma odpowiednie dwa klawisze w tym samym czasie.

../../_images/movement_8way.gif

Add a script to the character body and add the following code:

extends CharacterBody2D

@export var speed = 400

func get_input():
    var input_direction = Input.get_vector("left", "right", "up", "down")
    velocity = input_direction * speed

func _physics_process(delta):
    get_input()
    move_and_slide()

In the get_input() function, we use Input get_vector() to check for the four key events and sum return a direction vector.

We can then set our velocity by multiplying this direction vector, which has a length of 1, by our desired speed.

Wskazówka

If you've never used vector math before, or need a refresher, you can see an explanation of vector usage in Godot at Wektory.

Informacja

If the code above does nothing when you press the keys, double-check that you've set up input actions correctly as described in the Konfiguracja part of this tutorial.

Obrót i ruch

This type of movement is sometimes called "Asteroids-style" because it resembles how that classic arcade game worked. Pressing left/right rotates the character, while up/down moves it forward or backward in whatever direction it's facing.

../../_images/movement_rotate1.gif
extends CharacterBody2D

@export var speed = 400
@export var rotation_speed = 1.5

var rotation_direction = 0

func get_input():
    rotation_direction = Input.get_axis("left", "right")
    velocity = transform.x * Input.get_axis("down", "up") * speed

func _physics_process(delta):
    get_input()
    rotation += rotation_direction * rotation_speed * delta
    move_and_slide()

Here we've added two variables to track our rotation direction and speed. The rotation is applied directly to the body's rotation property.

To set the velocity, we use the body's transform.x which is a vector pointing in the body's "forward" direction, and multiply that by the speed.

Obrót i ruch (myszka)

This style of movement is a variation of the previous one. This time, the direction is set by the mouse position instead of the keyboard. The character will always "look at" the mouse pointer. The forward/back inputs remain the same, however.

../../_images/movement_rotate2.gif
extends CharacterBody2D

@export var speed = 400

func get_input():
    look_at(get_global_mouse_position())
    velocity = transform.x * Input.get_axis("down", "up") * speed

func _physics_process(delta):
    get_input()
    move_and_slide()

Here we're using the Node2D look_at() method to point the player towards the mouse's position. Without this function, you could get the same effect by setting the angle like this:

rotation = get_global_mouse_position().angle_to_point(position)

Click-and-move

This last example uses only the mouse to control the character. Clicking on the screen will cause the player to move to the target location.

../../_images/movement_click.gif
extends CharacterBody2D

@export var speed = 400

var target = position

func _input(event):
    if event.is_action_pressed("click"):
        target = get_global_mouse_position()

func _physics_process(delta):
    velocity = position.direction_to(target) * speed
    # look_at(target)
    if position.distance_to(target) > 10:
        move_and_slide()

Note the distance_to() check we make prior to movement. Without this test, the body would "jitter" upon reaching the target position, as it moves slightly past the position and tries to move back, only to move too far and repeat.

Uncommenting the look_at() line will also turn the body to point in its direction of motion if you prefer.

Wskazówka

This technique can also be used as the basis of a "following" character. The target position can be that of any object you want to move to.

Podsumowanie

You may find these code samples useful as starting points for your own projects. Feel free to use them and experiment with them to see what you can make.

You can download this sample project here: 2d_movement_starter.zip