Phaser.js: всё об играх и разработке

О чем этот пример

В игровом движке Phaser 3 система Path Followers позволяет легко создавать сложные траектории движения для игровых объектов. Этот пример демонстрирует, как заставить спрайт плавно двигаться по кривой Безье и автоматически возвращаться обратно, создавая эффект «йо-йо». Такой подход идеально подходит для анимации летающих врагов, патронов со сложной траекторией или перемещения объектов на карте без написания громоздкого кода вручную.

Версия Phaser: код и демо в этой статье рассчитаны на Phaser 3.90.0.

Живой запуск

Ниже встроен рабочий билд примера. Оригинальный источник: GitHub.

Исходный код

class Example extends Phaser.Scene
{
    preload ()
    {
        this.load.setBaseURL('https://raw.githubusercontent.com/phaserjs/examples/master/public/');
        this.load.image('ball', 'assets/sprites/shinyball.png');
    }

    create ()
    {
        const startPoint = new Phaser.Math.Vector2(50, 260);
        const controlPoint1 = new Phaser.Math.Vector2(610, 25);
        const controlPoint2 = new Phaser.Math.Vector2(320, 370);
        const endPoint = new Phaser.Math.Vector2(735, 550);

        const curve = new Phaser.Curves.CubicBezier(startPoint, controlPoint1, controlPoint2, endPoint);

        const graphics = this.add.graphics();

        graphics.lineStyle(1, 0xffffff, 1);

        curve.draw(graphics, 64);

        const ball = this.add.follower(curve, 50, 260, 'ball');

        ball.startFollow({
            duration: 3000,
            yoyo: true,
            ease: 'Sine.easeInOut'
        });
    }
}

const config = {
    type: Phaser.AUTO,
    width: 800,
    height: 600,
    backgroundColor: '#2d2d2d',
    parent: 'phaser-example',
    scene: Example
};

const game = new Phaser.Game(config);

Создание кривой Безье

Для определения траектории движения используется кривая Безье третьего порядка (кубическая). Она задаётся начальной точкой, конечной точкой и двумя контрольными точками, которые «притягивают» кривую, формируя плавный изгиб.

Вначале мы создаём четыре вектора, представляющие эти точки. Затем на их основе создаётся объект кривой.

const startPoint = new Phaser.Math.Vector2(50, 260);
const controlPoint1 = new Phaser.Math.Vector2(610, 25);
const controlPoint2 = new Phaser.Math.Vector2(320, 370);
const endPoint = new Phaser.Math.Vector2(735, 550);

const curve = new Phaser.Curves.CubicBezier(startPoint, controlPoint1, controlPoint2, endPoint);

Визуализация пути

Чтобы видеть созданную траекторию на экране, её необходимо нарисовать. Для этого используется объект Graphics. Мы задаём стиль линии и просим кривую отрисовать себя на этом графическом контексте. Аргумент 64 определяет количество сегментов, на которые разбивается кривая для отрисовки — чем больше число, тем плавнее будет выглядеть линия.

const graphics = this.add.graphics();
graphics.lineStyle(1, 0xffffff, 1);
curve.draw(graphics, 64);

Запуск follower с эффектом йо-йо

Ключевой объект — follower. Он создаётся с помощью метода this.add.follower(), который привязывает спрайт к созданной ранее кривой и указывает его начальную позицию (совпадающую с startPoint).

Запуск движения осуществляется методом startFollow(). В его конфигурации задаётся длительность движения от начала до конца кривой (в миллисекундах). Флаг yoyo: true заставляет объект, достигнув конца пути, развернуться и повторить траекторию в обратном направлении. Параметр ease определяет функцию плавности (easing), которая делает старт и остановку движения более естественными.

const ball = this.add.follower(curve, 50, 260, 'ball');
ball.startFollow({
    duration: 3000,
    yoyo: true,
    ease: 'Sine.easeInOut'
});

Настройка сцены и игры

Это стандартная конфигурация для примера на Phaser 3. В объекте config задаётся тип рендерера, размеры холста, цвет фона и корневой класс сцены. Экземпляр игры создаётся с этой конфигурацией.

const config = {
    type: Phaser.AUTO,
    width: 800,
    height: 600,
    backgroundColor: '#2d2d2d',
    parent: 'phaser-example',
    scene: Example
};
const game = new Phaser.Game(config);

Что попробовать дальше

Использование Path Follower с кривыми Безье — это мощный и лаконичный способ анимировать движение по сложным траекториям. Попробуйте экспериментировать: измените позиции контрольных точек для создания петель или острых поворотов, добавьте несколько follower на одну кривую с разной скоростью или используйте другие easing-функции из Phaser.Math.Easing для изменения характера движения (например, Back.easeOut для эффекта отскока).