🎓 Leçon Intermédiaire : Mouvement PNJ avec pause et animation

Niveau : Intermédiaire — Catégorie : “Déplacements guidés”
On ajoute du réalisme : animations + pause avec await et en_pause 🛑🎞️

---

🌱 Objectif

Faire en sorte qu’un PNJ marche entre deux points :

• 👣 En jouant une animation walk
• 😌 Puis s’arrête 3 secondes avec une animation idle
• Et reparte dans l’autre sens, en boucle !

---

🧰 Pré-requis

Tu dois déjà avoir :

• Un PNJ dans ta scène (ex: Fermier.tscn)
• Deux Node2D (PointA et PointB) dans la scène principale (PAS dans le PNJ !)
• Un AnimatedSprite2D avec au moins 4 animations : walk_right, walk_left, idle_right, idle_left

---

💡 Concepts nouveaux à comprendre

🧠 1. await et les fonctions asynchrones

Quand tu utilises await, tu dois être dans une fonction asynchrone, c’est-à-dire qui accepte l’attente sans bloquer le reste du moteur.

👉 await ne fonctionne pas bien dans _physics_process(), car cette fonction est appelée à chaque frame.

✅ Solution : on crée une fonction séparée (attendre_et_changer) dans laquelle on utilise await.

---

🧠 2. Le piège du mouvement pendant l’attente

Si tu ne bloques pas le mouvement du PNJ manuellement, il va continuer de bouger même pendant l’attente. 😬

✅ Solution : on utilise une variable en_pause pour désactiver le mouvement tant que la pause est active.

---

🧑‍💻 Script complet avec commentaires et emojis ✨

extends CharacterBody2D

@export var point_a: Node2D
@export var point_b: Node2D
@export var speed := 40.0
@onready var animated_sprite_2d: AnimatedSprite2D = $AnimatedSprite2D

var direction
var en_pause: bool = false
var current_target_node: Node2D

func _ready():
    current_target_node = point_a

func _physics_process(delta):
    if en_pause or current_target_node == null:
        velocity = Vector2.ZERO
        return

    var target_pos = current_target_node.global_position
    direction = (target_pos - global_position).normalized()
    velocity = direction * speed
    move_and_slide()

    if global_position.distance_to(target_pos) < 2.0:
        en_pause = true
        await attendre_et_changer()

    animation()

func animation():
    if direction.x > 0:
        animated_sprite_2d.play("walk_right")
    elif direction.x < 0:
        animated_sprite_2d.play("walk_left")

func attendre_et_changer() -> void:
    if direction.x > 0:
        animated_sprite_2d.play("idle_right")
    else:
        animated_sprite_2d.play("idle_left")

    await get_tree().create_timer(3.0).timeout

    if current_target_node == point_a:
        current_target_node = point_b
    else:
        current_target_node = point_a

    en_pause = false

---

🧪 Astuces et pièges à éviter

• Ne jamais mettre await dans _physics_process() → toujours créer une fonction dédiée
• N’oublie pas de tester dans la scène principale ! Sinon, PointA ou PointB vaudront null
• Tu peux ajuster la distance de déclenchement (ici 2.0) pour qu’il ne s’arrête pas trop tôt

---

🌟 Bonus sonore : ajouter un bruit de pas

🔊 Pourquoi un son de pas ?

Tu veux que ton personnage ne glisse pas en silence, mais laisse entendre ses pas dans l’herbe ou sur les cailloux ? Voilà comment ajouter un son réaliste 🐾🌿

---

🎧 Étape 1 — Récupérer un son

Télécharge un son libre sur :

🔗 https://pixabay.com/sound-effects/
Cherche : grass footsteps, walk, step, etc.

Dépose-le dans ton projet :
assets/audio/footstep_grass.wav

---

🧩 Étape 2 — Ajouter un AudioStreamPlayer2D

1. Dans ton PNJ, ajoute un enfant : AudioStreamPlayer2D
2. Dans l’inspecteur :
   • Associe ton fichier son à Stream
   • Ne coche Loop que si le son est très court ⛔
   • Sinon, il se relance manuellement

Tu peux le nommer footstep_pnj

---

⚙️ Étape 3 — Lancer et arrêter le son dans le script

@onready var footstep_pnj = $AudioStreamPlayer2D

func _physics_process(delta):
    if en_pause:
        velocity = Vector2.ZERO
        footstep_pnj.stop() # ⛔ Stop quand en pause
        return

    # ...
    move_and_slide()

    if not footstep_pnj.playing:
        footstep_pnj.play()

---

💡 Astuces sonores

• Si ton son est déjà complet (genre 1–2 secondes), pas besoin de loop
• Tu peux jouer le son toutes les 0.3–0.5 sec avec un Timer
• Pour aller plus loin : changer le son selon le sol (herbe, pierre, plancher…)

---

🌈 Et voilà ! Tu entends ton personnage marcher 🐾
Tu veux qu’on ajoute un bruit différent selon les tuiles ou des effets météo après ? 🌧️🎵