Эффекты
Эффекты временно берут управление над сущностью для сложных действий, таких как рывки, атаки, анимации поедания, кат-сцены или последовательности смерти/возрождения.
Эффекты можно использовать на игроках, NPC или любой сущности. Они особенно полезны, когда вам нужно:
Движение, которое вы контролируете в коде (рывок/отбрасывание/перекат)
«Блокировать» ввод игрока на короткую последовательность (есть, воскрешение, кат-сцена)
Ограниченное по времени состояние (неуязвимость, замедление, оглушение)
UI, привязанное к временному состоянию (таймер возрождения)
Активные и пассивные
All Out поддерживает два вида эффектов:
Активные эффекты: по одному за раз на сущность. Установка нового активного эффекта прерывает текущий активный эффект.
Пассивные эффекты: можно прикрепить несколько одновременно (стекающиеся баффы/дебаффы/статусные эффекты).
Быстрый старт (простой эффект с таймером)
Создайте класс, наследующийся от 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_updateeffect_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().
Последнее обновление