🚶‍♀️ Mouvement Top-Down de Base + Attack (Godot 4.4)

Un script simple pour déplacer ton personnage en vue de dessus, comme dans les jeux à la Zelda ! 🧝‍♂️✨

---

🎮 Le script de base (à mettre sur un CharacterBody2D)

extends CharacterBody2D

@onready var animated_sprite: AnimatedSprite2D = $AnimatedSprite2D
@export var vitesse: float = 40.0

var direction: Vector2 = Vector2.ZERO
var last_direction: Vector2 = Vector2.DOWN  # direction par défaut

func _physics_process(_delta: float) -> void:
	move_player()
	animation_player()
	move_and_slide()

func move_player():
	direction = Input.get_vector("left", "right", "up", "down")

	# 🧠 On garde en mémoire la dernière direction utilisée
	if direction != Vector2.ZERO:
		last_direction = direction

	velocity = direction * vitesse

func animation_player():
	if direction != Vector2.ZERO:
		if direction.x > 0:
			animated_sprite.play("walk_right")
		elif direction.x < 0:
			animated_sprite.play("walk_left")
		elif direction.y > 0:
			animated_sprite.play("walk_down")
		elif direction.y < 0:
			animated_sprite.play("walk_up")
	else:
		if last_direction.x > 0:
			animated_sprite.play("idle_right")
		elif last_direction.x < 0:
			animated_sprite.play("idle_left")
		elif last_direction.y > 0:
			animated_sprite.play("idle_down")
		elif last_direction.y < 0:
			animated_sprite.play("idle_up")

---

🧾 Résumé

• direction ➜ direction actuelle selon les touches appuyées 🎯
• last_direction ➜ garde la dernière direction pour les animations idle 🧭
• velocity = direction * vitesse ➜ applique la vitesse
• move_and_slide() ➜ déplace le personnage

---

🚀 Aller plus loin : 3 façons d’améliorer ce système

1️⃣ Méthode simple avec if / elif ✅

Celle qu’on utilise ici. Lisible, facile à comprendre.
Parfait pour débuter 💪

---

2️⃣ Méthode avec match 🎯

Plus compacte, mais attention : elle ne marche que si la direction est exactement (1, 0), (0, -1), etc.

func animation_player():
	if velocity:
		match direction:
			Vector2.RIGHT:
				animated_sprite.play("walk_right")
			Vector2.LEFT:
				animated_sprite.play("walk_left")
			Vector2.DOWN:
				animated_sprite.play("walk_down")
			Vector2.UP:
				animated_sprite.play("walk_up")
	else:
		match last_direction:
			Vector2.RIGHT:
				animated_sprite.play("idle_right")
			Vector2.LEFT:
				animated_sprite.play("idle_left")
			Vector2.DOWN:
				animated_sprite.play("idle_down")
			Vector2.UP:
				animated_sprite.play("idle_up")

🧠 Astuce : si tu veux que match fonctionne bien, pense à arrondir les directions avec round().

---

3️⃣ Utiliser une State Machine 🧩 (Machine à États)

Quand ton jeu devient plus complexe (parler, attaquer, rouler…), c’est mieux d’organiser le code en “états” :

enum State 

var current_state = State.IDLE

func _physics_process(_delta):
	match current_state:
		State.IDLE:
			handle_idle()
		State.WALK:
			handle_walk()
		State.ATTACK:
			handle_attack()

🧘‍♀️ Chaque état a son propre comportement. C’est plus clean, mais un peu plus avancé.

---

🛠️ Astuce Debug : animations qui restent bloquées en “walk” ?

➡️ Vérifie cette ligne :

if direction != Vector2.ZERO:
	last_direction = direction

⚠️ Ne fais pas if last_direction != Vector2.ZERO, c’est une erreur classique.

---

🐾 Conclusion

Commence simple avec les if pour bien tout comprendre.
Quand tu seras à l’aise, tu pourras passer à une version plus flexible avec match ou une State Machine.

---

⚔️ Faire attaquer son personnage (Godot 4.4)

On ajoute la possibilité d’attaquer avec l’animation correspondante (vers le haut, bas, gauche, droite).

🔧 Ce qu’il faut prévoir

• Avoir 4 animations dans l’AnimatedSprite2D :
  • attack_down, attack_up, attack_left, attack_right
• Avoir une Input Map avec l’action attack

🔹 Variables à ajouter

var is_attacking: bool = false
var attack_cooldown := 0.4
var attack_timer := 0.0

👉 Modifier _physics_process

func _physics_process(delta: float) -> void:
	if is_attacking:
		attack_timer -= delta
		if attack_timer <= 0:
			is_attacking = false
	else:
		if Input.is_action_just_pressed("attack"):
			start_attack()
		else:
			move_player()

	animation_player()
	move_and_slide()

🧻 Fonction start_attack()

func start_attack():
	is_attacking = true
	attack_timer = attack_cooldown

	if last_direction.x > 0:
		animated_sprite.play("attack_right")
	elif last_direction.x < 0:
		animated_sprite.play("attack_left")
	elif last_direction.y > 0:
		animated_sprite.play("attack_down")
	elif last_direction.y < 0:
		animated_sprite.play("attack_up")

💡 Adapter animation_player()

func animation_player():
	if is_attacking:
		return

	if direction != Vector2.ZERO:
		if direction.x > 0:
			animated_sprite.play("walk_right")
		elif direction.x < 0:
			animated_sprite.play("walk_left")
		elif direction.y > 0:
			animated_sprite.play("walk_down")
		elif direction.y < 0:
			animated_sprite.play("walk_up")
	else:
		if last_direction.x > 0:
			animated_sprite.play("idle_right")
		elif last_direction.x < 0:
			animated_sprite.play("idle_left")
		elif last_direction.y > 0:
			animated_sprite.play("idle_down")
		elif last_direction.y < 0:
			animated_sprite.play("idle_up")

🤖 Ce que ça change

• Quand tu appuies sur attack, l’animation d’attaque joue dans la bonne direction
• Le personnage s’arrête pendant l’attaque
• Une fois le timer fini, tu peux re-bouger

🎉 Bravo !

Tu peux maintenant animer des attaques dans toutes les directions ✨

Prochaine étape : ajouter des Hitbox pour détecter les ennemis ! 😈

---

👩‍💻 Écrit par Lysdora
✨ Projet : mon-rpg-zelda