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

using System;
using Godot;

/// <summary>
/// Базовий клас для ворожих сутностей (NPC), які переслідують ціль (за замовчуванням - гравця,
/// див. <see cref="PathfindingGameEntity2D.TargetRef"/>) і завдають їй шкоди в разі контакту, а самі
/// можуть отримувати шкоду. Бойова частина - той самий інтерфейс IDamagable і та сама механіка
/// "стрибок на голову вбиває, дотик збоку шкодить гравцю", що й у EnemyCrab (тема 19). Різниця -
/// у русі: замість "іти вперед, доки не вдаришся об стіну" ворог тепер користується pathfinding-ом,
/// тобто вміє підійматися на платформи та перестрибувати прірви, щоб дістатися цілі.
/// </summary>
public abstract partial class PathfindingGameEnemy2D : PathfindingGameEntity2D, IDamagable
{
    [ExportGroup("Combat")]
    [Export] public int Health = 1;
    [Export] public int Damage = 1;
    [Export] public string AttackAnimName = "Attack";

    private Area2D hitbox;
    private bool isAttacking;

    public event Action<DamageInfo> Damaged;
    public event Action Died;

    // PathfindingGameEntity2D уже має protected IsDying/IsDead (обидва з private set), тому
    // IDamagable.IsDead реалізовано явно, а не звичайною властивістю - інакше вона конфліктувала б
    // з успадкованою (CS0108). IsDying стає true одразу на початку смерті (в StartDying()), тоді як
    // успадкований IsDead встановлюється лише в Cleanup(), вже після анімації смерті - для
    // IDamagable потрібен саме перший, раніший момент.
    bool IDamagable.IsDead => IsDying;

    /// <summary>Пропускає pathfinding не лише в станах з PathfindingGameEntity2D, а й під час атаки.</summary>
    protected override bool MovementSuspended => base.MovementSuspended || isAttacking;

    protected override void OnAgentReady()
    {
        base.OnAgentReady();
        if (AnimSprite == null) { return; } // base.OnAgentReady() вже викликав DisableEntity()

        hitbox = GetNodeOrNull<Area2D>("Area2D");
        if (hitbox == null)
        {
            GD.PushError($"{Name}: Required child node 'Area2D' (type: Area2D) not found. " +
                "Add it as a child of this node. Entity is disabled.");
            DisableEntity();
            return;
        }
        hitbox.BodyEntered += OnHitboxBodyEntered;
    }

    /// <summary>
    /// Реалізація IDamagable.TakeDamage - та сама механіка, що й у EnemyCrab: зменшує Health,
    /// застосовує відскок до атакуючого (info.ApplyBounceToSource), повідомляє про удар, а коли
    /// здоров'я досягає нуля, запускає смерть через StartDying() (успадкований з PathfindingGameEntity2D).
    /// </summary>
    public void TakeDamage(DamageInfo info)
    {
        if (IsDying) { return; } // мертвого не можна вбити двічі

        Health -= info.Amount;
        info.ApplyBounceToSource();
        Damaged?.Invoke(info);

        if (Health <= 0)
        {
            Died?.Invoke();
            StartDying();
        }
    }

    /// <summary>
    /// Спрацьовує, коли гравець торкається хітбоксу цього ворога. Як і в EnemyCrab: якщо гравець
    /// зверху - це стрибок на голову (ворог отримує шкоду й відкидає гравця), інакше - дотик
    /// збоку (ворог завдає шкоди гравцю).
    /// </summary>
    private void OnHitboxBodyEntered(Node2D body)
    {
        if (IsDying || body is not Player player) { return; }

        bool playerAbove = GlobalPosition.Y - player.GlobalPosition.Y > 10f;
        if (playerAbove)
        {
            TakeDamage(new DamageInfo(player.StompDamage, player, new Vector2(player.Velocity.X, player.StompBounceVelocity)));
        }
        else
        {
            AttackPlayer(player);
        }
    }

    /// <summary>Завдає шкоди гравцю та на час анімації атаки зупиняє власний рух.</summary>
    protected virtual void AttackPlayer(Player player)
    {
        isAttacking = true;
        AnimSprite.Play(AttackAnimName);
        player.TakeDamage(new DamageInfo(Damage, this));
    }

    protected override void OnAnimationFinished()
    {
        if (isAttacking && AnimSprite.Animation == AttackAnimName)
        {
            isAttacking = false;
            return;
        }
        base.OnAnimationFinished();
    }
}