For the complete documentation index, see llms.txt. This page is also available as Markdown.

Эффекты

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

Эффекты можно использовать на игроках, 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_start(): вызывается один раз, когда эффект прикрепляется

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

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

  • effect_draw(dt): только косметическая отрисовка на кадрах с рендерингом

  • effect_end(interrupt): вызывается, когда эффект удаляется

effect_draw включает игроков и пропускает resim. Интерактивный UI должен использовать effect_update/effect_late_update, никогда effect_draw.

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

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

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

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

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

Справочник по API

Effect_Base

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

Проверка / перебор эффектов

freeze_player против disable_movement_inputs

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

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

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

Эмоции игрока

Эмоции игрока используют встроенный активный эффект. Запуск другой эмоции прерывает текущую эмоцию, тогда как любой другой активный эффект не позволяет начать новую эмоцию. Движение прерывает эмоции и восстанавливает основной слой анимации, кроме Emote/T_Pose, который позволяет двигаться.

Используйте причины блокировки, когда геймплей должен временно запретить колесу эмоций запускать эмоцию:

Причины считаются как записи, поэтому соответствующие вызовы add/remove важны. remove_emote_block_reason удаляет одну совпадающую запись и возвращает, была ли она найдена. Используйте has_emote_block_reason(reason) для проверки одной причины и has_any_emote_block_reason() чтобы проверить, активна ли какая-либо из них. Вы также можете напрямую управлять встроенным эффектом:

try_trigger_emote возвращает false когда анимация не экипирована, эмоции заблокированы или другой вид активного эффекта управляет игроком. Обычное колесо эмоций использует тот же путь.

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

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

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

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

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

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

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

Плавная кастомная визуализация

Симуляция работает с фиксированной частотой, тогда как рендеринг может идти быстрее. Отрисовка из колбэка компонента автоматически привязана к сущности этого компонента. В остальных случаях:

  • Оберните отрисовку в мировом пространстве для другой сущности в UI.begin_world_space_ui(entity) и UI.end_world_space_ui().

  • Для движущейся позиции, которая не принадлежит сущности, храните постоянный Position_Interpolation_Helper. Передайте смещение из update(position) в UI.push_interpolation_offset, затем удалите его после отрисовки.

  • Используйте постоянный Float_Interpolation_Helper с UI.quad_fill для меняющегося значения полосы.

  • Вызывайте entity.mark_teleported() после дискретного изменения позиции.

Храните вспомогательные объекты интерполяции в постоянном состоянии компонента или UI. Вспомогательный объект, созданный внутри метода draw, не имеет предыдущего кадра, от которого можно интерполировать.

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

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

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

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

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

  • Запускайте игровые эффекты по общей предсказанной ветке.

  • effect_draw используется только для косметики. Рисуйте интерактивный UI эффекта из ao_late_update в is_local_or_server().

Последнее обновление