NEW BOT Телеграм, страница

Devlog без QA | Розробка ігор

💭 Гнучкі ефекти з C# Generic Interfaces

У сучасних системах здібностей (abilities) зручніше працювати не з конкретними класами, а з інтерфейсами.

Generic Interfaces (IEffect<TTarget>) дозволяють створювати універсальні ефекти, які можна застосовувати до будь-якого типу об’єктів без дублювання коду.

1️⃣ IEffect. Універсальний ефект

Визначає логіку будь-якого ефекту (шкода, лікування, бафи).

Має Apply, Cancel і подію OnCompleted.

public interface IEffect<T> {
    IEffect<T> CreateInstance();
    void Apply(T target);
    void Cancel();
    event Action<IEffect<T>> OnCompleted;
}

🔹 Використання generics гарантує типобезпеку. Наприклад, IEffect<IDamageable> можна застосувати лише до цілей, які реалізують IDamageable.

2️⃣ IDamageable. Будь-який об’єкт, що може отримати шкоду

Це базовий інтерфейс для всіх «пошкоджених» об’єктів.

public interface IDamageable {
    void TakeDamage(int amount);
}

Будь-який клас, який реалізує цей інтерфейс, автоматично сумісний з ефектами, не змінюючи їх код.
Так, Enemy реалізує IDamageable, тому може приймати ефекти без додаткової логіки.

3️⃣ Миттєві та довготривалі ефекти

DamageEffect одразу наносить шкоду.
DamageOverTimeEffect працює з таймером і завдає шкоду з інтервалом.

public void Apply(IDamageable t) {
    t.TakeDamage(damageAmount);
    OnCompleted?.Invoke(this);
}

Таймер автоматично зупиняє ефект і викликає OnCompleted.

4️⃣ Ability. Набір ефектів

[Serializable]
public class Ability {
    // Список ефектів, які складають цю здібність.
    // [SerializeReference] дозволяє в інспекторі Unity змішувати різні типи ефектів (DamageEffect, DamageOverTimeEffect тощо)
    [SerializeReference] public List<IEffect<IDamageable>> effects = new();

    // Метод виконання здібності на конкретній цілі
    public void Execute(IDamageable t) {
        if (t == null) return; // захист від null-цілі

        foreach (var e in effects) {
            // Створюємо окрему інстанцію ефекту для цього застосування,
            // щоб уникнути спільного стану (таймери, currentTarget) між цілями
            var instance = e.CreateInstance();
            if (instance == null) continue;

            // Якщо ціль — Enemy, застосовуємо через ApplyEffect,
            // який відслідковує активні ефекти та підписується на OnCompleted
            if (t is Enemy enemy)
                enemy.ApplyEffect(instance);
            else
                // Інакше застосовуємо ефект без додаткового трекінгу
                instance.Apply(t);
        }
    }
}

🔹 [SerializeReference] дозволяє змішувати різні типи ефектів прямо в інспекторі. Одна здібність може містити кілька ефектів (наприклад, удар + отрута).

5️⃣ Enemy. Керування ефектами
Enemy зберігає активні ефекти й очищає їх при смерті:

void Die() {
    foreach (var e in activeEffects) e.Cancel();
    activeEffects.Clear();
}

🔹 Подія OnCompleted прибирає завершені ефекти.
🔹 Cancel() зупиняє активні (DoT) при смерті.

6️⃣ PlayerAbilityCaster. Запуск здібностей

if (Input.GetKeyDown(KeyCode.Alpha1))
    Cast(hotbar[0], FindFirstObjectByType<Enemy>());

Викликає здібності з клавіш, додає VFX/SFX і керує виконанням.

(Враховуючи, що цей код лише для прикладу, то [Детальніше тут]) 👈

Якщо говорити про плюси, така система дозволяє легко додавати нові ефекти без зміни основного коду і робить їх повністю повторно використовуваними.

Вона також забезпечує чітку архітектуру, що значно спрощує підтримку та масштабування ігрової механіки.

✈️

Gamedev | #уроки #CSharp #GenericInterfaces

Please open Telegram to view this post