Ворожий NPC: переслідування та combat

1. 1
   Базовий клас

   Створіть PathfindingGameEnemy2D (Code/Objects), як у теорії, і натисніть Build - помилок бути не повинно.

2. 2
   Краб

   Створіть CrabHostile.cs і CrabHostile.tscn (Scenes/Enemies/CrabHostile) за кроками з теорії. Не забудьте PathFindTimer - без нього краб не оновлюватиме шлях.

3. 3
   Рівень

   Додайте краба в Level1 (Objects/Enemies, позиція (754, 225)). Дружнього краба видаліть.

Краб має поводитися так:

Коли краб кусає гравця, у панелі Output має з'являтися повідомлення, наприклад CrabHostile вкусив гравця!.

Атакою займається метод AttackPlayer() з PathfindingGameEnemy2D. Він virtual, тож у CrabHostile його можна перевизначити - додати свою дію, не чіпаючи базовий клас.

Як перевизначити метод

1. Усередині класу CrabHostile напишіть заголовок методу, так само як у базовому класі, але замість virtual - override. Порада: наберіть override і пробіл - редактор покаже список методів, які можна перевизначити.
2. Першим рядком викличте base.AttackPlayer(player) - це звичайна атака з базового класу (анімація + шкода гравцю). Без цього рядка краб перестане кусатися!
3. Після нього - ваш код.

protected override void AttackPlayer(Player player)
{
    base.AttackPlayer(player); // спершу - звичайна атака з PathfindingGameEnemy2D

    // ваш код тут
}

Вивести повідомлення: GD.Print("текст");. Ім'я вузла краба - властивість Name: GD.Print($"{Name} вкусив гравця!");

У тому самому AttackPlayer() із завдання 2 збільшуйте швидкість краба на 15 після кожної атаки та виводьте нову швидкість в Output.

Швидкість - це поле Speed з PathfindingAgent2D (у сцені краба воно дорівнює 60). Воно public, тож у CrabHostile до нього можна звертатися просто за іменем:

Speed += 15f;                          // те саме, що Speed = Speed + 15f;
GD.Print($"Нова швидкість: {Speed}");

Speed = Mathf.Min(Speed + 15f, 150f);

Смерть запускає метод StartDying() з PathfindingGameEntity2D. Перевизначте його в CrabHostile, так само як AttackPlayer() у завданні 2, і переверніть спрайт по вертикалі.

protected override void StartDying()
{
    base.StartDying(); // анімація смерті та зупинка руху

    // ваш код тут
}

Перевернути спрайт: AnimSprite.FlipV = true; - так само, як FlipH (віддзеркалення вліво-вправо), лише по вертикалі. AnimSprite - це AnimatedSprite2D краба, базовий клас уже знайшов його за вас.

Що станеться, якщо прибрати рядок base.StartDying();? Спробуйте, а потім поверніть його.

Задайте крабу Health = 3. При кожному ударі на мить змінюйте колір спрайту через Modulate (як у завданні 3 теми 19).

Один стрибок іноді зараховується двічі - це нормально.

Tween tween = CreateTween(); // CreateTween() є в кожного Node - зокрема в самого краба
tween.TweenProperty(AnimSprite, "modulate", Colors.White, 0.2f); // за 0.2 с стати білим

AnimSprite

"modulate"

Colors.White

0.2f

AnimSprite.Modulate = new Color(1f, 0.3f, 0.3f); // миттєво: червонуватий
Tween tween = CreateTween();
tween.TweenProperty(AnimSprite, "modulate", Colors.White, 0.2f); // плавно назад

Tween tween = CreateTween();
tween.TweenProperty(AnimSprite, "modulate", Colors.Red, 0.1f);   // 0.1 с: до червоного
tween.TweenProperty(AnimSprite, "modulate", Colors.White, 0.1f); // потім 0.1 с: назад до білого

private Tween hitTween; // поле класу

// ...у методі, що запускає мигання:
hitTween?.Kill();         // ?. - бо під час першого удару твіна ще немає (null)
hitTween = CreateTween();
hitTween.TweenProperty(AnimSprite, "modulate", Colors.White, 0.2f);

using System.Threading.Tasks; // на початку файлу

private async void FlashRed()
{
    AnimSprite.Modulate = new Color(1f, 0.3f, 0.3f);
    await Task.Delay(200);                  // 200 мілісекунд (не секунд!)
    if (!IsInstanceValid(this)) { return; } // краб міг зникнути, поки ми чекали
    AnimSprite.Modulate = Colors.White;
}

Додайте в CrabHostile змінну AggroDistance. Перевизначте GetDestination(): якщо гравець далі за AggroDistance - поверніть null, інакше - результат базового методу.

Краб має зупинятися, коли гравець виходить із зони. Чи так це, якщо краб уже йде до гравця? Поясніть і виправте.

[ExportGroup("Aggro")]
[Export] public float AggroDistance = 250f; // px

base.GetDestination()

GlobalPosition.DistanceTo(targetPosition.Value)

ClearCurrentPath();

protected override Vector2? GetDestination()
{
    Vector2? targetPosition = base.GetDestination(); // позиція гравця або null

    // TODO: якщо гравця немає (null) - поверніть null
    // TODO: якщо гравець далі за AggroDistance - поверніть null

    return targetPosition;
}

Робіть це завдання на копії проєкту: ви змінюєте спільний базовий клас.

Поверніть дружнього краба на рівень і призначте його ворожому як TargetOverride (інспектор, група Targeting). Що відбувається, коли краби зустрічаються? Чому?

Потім зробіть так, щоб ворог атакував будь-який IDamagable, а не лише Player. Дружній краб теж має реалізувати IDamagable (завдання 4 теми 20).