Эффекты

Эффекты временно берут управление над сущностью для сложных действий, таких как рывки, атаки, анимации еды, кат-сцены или последовательности смерти/возрождения.

Эффекты можно применять к игрокам, NPC или любой сущности. Они особенно полезны, когда вам нужно:

• Движение, которым вы управляете в коде (рывок/отбрасывание/перекат)

• Коротко «заблокировать» ввод игрока на время последовательности (еда, воскрешение, кат-сцена)

• Ограниченное по времени состояние (неуязвимость, замедление, оглушение)

• UI, привязанный к временному состоянию (обратный отсчёт до возрождения)

Активные и пассивные

All Out поддерживает два вида эффектов:

• Активные эффекты: по одному за раз на сущность. Установка нового активного эффекта прерывает текущий активный эффект.

• Пассивные эффекты: можно одновременно навесить несколько (стекающиеся баффы/дебаффы/статусные эффекты).

Активный эффект также добавляется в список эффектов сущности, поэтому он появляется в effect_iterator так же, как и пассивные эффекты.

Быстрый старт (простой эффект с таймером)

Создайте класс, который наследуется от Effect_Base, а затем прикрепите его к сущности.

Apple_Pop_Effect :: class : Effect_Base {
    sprite: Sprite_Renderer;
    start_scale: v2;
    start_pos: v2;

    effect_start :: method() {
        sprite = entity->get_component(Sprite_Renderer);
        start_scale = entity.local_scale;
        start_pos = entity.local_position;
        set_duration(0.4); // автоматически удаляется через 0.4 с
    }

    effect_update :: method(dt: float) {
        t := get_elapsed_time() / 0.4;

        // Увеличить, а затем уменьшить до нуля
        scale_curve: float;
        if t < 0.3 {
            scale_curve = lerp(1.0, 1.3, Ease.out_back(t / 0.3));
        } else {
            scale_curve = lerp(1.3, 0.0, Ease.in_back((t - 0.3) / 0.7));
        }

        entity->set_local_scale(start_scale * scale_curve);

        // Немного подняться вверх
        rise := Ease.out_quad(t) * 0.5;
        entity->set_local_position({start_pos.x, start_pos.y + rise});

        // Исчезнуть ближе к концу
        if sprite != null {
            alpha := 1.0 - Ease.in_quad(max(0.0, (t - 0.5) / 0.5));
            sprite.color.w = alpha;
        }
    }

    effect_end :: method(interrupt: bool) {
        // Очистить всё, когда закончено (или прервано)
        entity->destroy();
    }
}

Прикрепите его как активный эффект:

effect := new(Apple_Pop_Effect);
entity->set_active_effect(effect);

Жизненный цикл эффекта

Эффекты основаны на колбэках. Реализуйте только то, что вам нужно:

• effect_start(): вызывается один раз при прикреплении эффекта

• effect_update(dt): вызывается каждый кадр

• effect_late_update(dt): вызывается каждый кадр после effect_update

• effect_end(interrupt): вызывается при удалении эффекта

Активные эффекты (исключительный контроль)

Используйте set_active_effect для эффектов, которые должны быть взаимоисключающими (рывок, подготовка атаки, последовательность смерти).

dash := new(Dash_Effect);
dash.direction = {1, 0};
player.entity->set_active_effect(dash);

Если у сущности уже есть активный эффект, он завершается с interrupt = true.

Пассивные эффекты (стекающиеся баффы / статус)

Используйте add_passive_effect для эффектов, которые могут складываться (замедление, яд, щит, окно неуязвимости).

slow := new(Slow_Effect);
slow.speed_multiplier = 0.5;
slow->set_duration(4.0);
enemy.entity->add_passive_effect(slow);

Справочник API

Effect_Base

Effect_Base :: class {
    entity: Entity;
    player: Player; // null, если этот эффект не был добавлен к игроку!

    player_specific: struct {
        freeze_player: bool;
        disable_movement_inputs: bool;
    };

    // Необязательные колбэки
    #interface effect_start       :: proc(c: Effect_Base);
    #interface effect_update      :: proc(c: Effect_Base, dt: float);
    #interface effect_late_update :: proc(c: Effect_Base, dt: float);
    #interface effect_end         :: proc(c: Effect_Base, interrupt: bool);

    // Только для чтения
    start_time: float;
    next_effect: Effect_Base;
    prev_effect: Effect_Base;

    get_elapsed_time :: method() -> float;
    set_duration     :: method(duration: float);
    remove_effect    :: method(interrupt: bool);
}

Применение / удаление эффектов

set_active_effect  :: proc(entity: Entity, new_active_effect: $T);
add_passive_effect :: proc(entity: Entity, new_effect: $T);

remove_all_effects :: proc(entity: Entity);
remove_effect      :: proc(entity: Entity, type: typeid, interrupt: bool) -> bool;

Проверка / итерация по эффектам

get_effect :: proc(entity: Entity, $T: typeid, mode := Try_Get_Effect_Mode.EXACT_MATCH) -> T, bool;
has_effect :: proc(entity: Entity, $T: typeid, mode := Try_Get_Effect_Mode.EXACT_MATCH) -> bool;

effect_iterator :: proc(entity: Entity) -> Effect_Iterator;

После вызова remove_effect(...), объект эффекта освобождается. Сразу возвращайтесь и не обращайтесь к this после удаления.

freeze_player vs disable_movement_inputs

• player_specific.freeze_player = true: полностью блокирует позицию игрока.

• player_specific.disable_movement_inputs = true: игнорирует ввод, но ваш эффект всё ещё может перемещать игрока (рывок/перекат).

Оба применяются только когда player != null (то есть эффект находится на сущности, у которой есть Player компонент).

Примеры эффектов

Рывок / перекат (активный эффект)

Roll_Effect :: class : Effect_Base {
    direction: v2;
    original_friction: float;

    effect_start :: method() {
        player_specific.disable_movement_inputs = true;
        original_friction = player.agent.friction;
        player.agent.friction = 0;
        player.animator.instance.state_machine->set_trigger("dodge_roll");
        player->set_facing_right(direction.x > 0);
        set_duration(0.5);
    }

    effect_update :: method(dt: float) {
        player.agent.velocity = direction * 8;
    }

    effect_end :: method(interrupt: bool) {
        player.agent.friction = original_friction;
    }
}

Окно неуязвимости (пассивный эффект)

Используйте пассивный эффект для представления состояния неуязвимости и проверяйте его везде, где наносится урон.

Invincible_Effect :: class : Effect_Base {
}

give_invincibility :: proc(player: Player, seconds: float) {
    e := new(Invincible_Effect);
    e->set_duration(seconds);
    player.entity->add_passive_effect(e);
}

// Пример проверки урона:
take_damage :: proc(player: Player, amount: s64) {
    if player.entity->has_effect(Invincible_Effect) {
        return;
    }
    player.health->take_damage(amount);
}

Увеличение в 2 раза на несколько секунд (пассивный эффект)

Grow_Effect :: class : Effect_Base {
    scale_multiplier: float;
    start_scale: v2;

    effect_start :: method() {
        start_scale = entity.local_scale;
        entity->set_local_scale(start_scale * scale_multiplier);
    }

    effect_end :: method(interrupt: bool) {
        entity->set_local_scale(start_scale);
    }
}

apply_grow :: proc(entity: Entity) {
    e := new(Grow_Effect);
    e.scale_multiplier = 2.0;
    e->set_duration(3.0);
    entity->add_passive_effect(e);
}

Последовательность смерти / возрождения (активный эффект с локальным UI)

Death_Effect :: class : Effect_Base {
    effect_start :: method() {
        player_specific.freeze_player = true;
        player->add_name_invisibility_reason("death");
        player.animator.instance.state_machine->set_trigger("death");
    }

    effect_update :: method(dt: float) {
        time_until_respawn := 5.0 - get_elapsed_time();

        if player->is_local() {
            ts := UI.default_text_settings();
            ts.size = 64;
            rect := UI.get_screen_rect()->bottom_center_rect()->offset(0, 150);
            UI.text(rect, ts, "Respawning in %s", {time_until_respawn.(int) + 1});
        }

        if time_until_respawn <= 0 {
            remove_effect(false);
            return;
        }
    }

    effect_end :: method(interrupt: bool) {
        player->remove_name_invisibility_reason("death");
        respawn_player(player); // определяемое пользователем: телепортировать игрока в точку появления
        player.health->reset();
        player.animator.instance.state_machine->set_trigger("RESET");
    }
}

Блокировка кат-сцены (активный эффект)

Cutscene_Effect :: class : Effect_Base {
    effect_start :: method() {
        player_specific.freeze_player = true;
        set_duration(2.0);
    }

    effect_late_update :: method(dt: float) {
        if player != null && player->is_local() {
            Notifier.notify("Кат-сцена...");
        }
    }
}

Лучшие практики

• Используйте set_active_effect когда эффект «владеет» сущностью в течение короткой последовательности (рывок/атака/смерть/кат-сцена).

• Используйте add_passive_effect для стекающегося состояния (баффы/дебаффы/статус).

• Используйте set_duration(...) для эффектов с таймером вместо ручных таймеров.

• Всегда восстанавливайте любое изменённое состояние в effect_end (трение, масштаб, триггеры анимации и т. д.).

• Держите носят чисто косметический характер UI/эффекты локальные (оборачивайте в player->is_local()), а состояние геймплея держите авторитетным на сервере.