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

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

Движение по заданному пути — основа анимации персонажей, врагов, снарядов и камер в играх. Использование кривых и твинов для описания движения отделяет логику перемещения от визуализации, делая код чище, а анимацию — более контролируемой и гибкой. Этот подход незаменим для создания орбитального движения планет, циклических патрулей врагов или плавных полётов снарядов.

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

Живой запуск

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

Исходный код

class Example extends Phaser.Scene
{
    graphics;
    path;
    follower;

    create ()
    {
        this.graphics = this.add.graphics();

        this.follower = { t: 0, vec: new Phaser.Math.Vector2() };

        this.path = new Phaser.Curves.Path();

        this.path.add(new Phaser.Curves.Ellipse(400, 300, 100));

        this.tweens.add({
            targets: this.follower,
            t: 1,
            ease: 'Sine.easeInOut',
            duration: 4000,
            yoyo: true,
            repeat: -1
        });
    }

    update ()
    {
        this.graphics.clear();
        this.graphics.lineStyle(2, 0xffffff, 1);

        this.path.draw(this.graphics);

        this.path.getPoint(this.follower.t, this.follower.vec);

        this.graphics.fillStyle(0xff0000, 1);
        this.graphics.fillCircle(this.follower.vec.x, this.follower.vec.y, 12);
    }
}

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

const game = new Phaser.Game(config);

Инициализация сцены и необходимых объектов

Класс сцены Example хранит три ключевых объекта: graphics для рисования, path для описания кривой и follower — объект-последователь, который будет двигаться по пути.

class Example extends Phaser.Scene
{
    graphics;
    path;
    follower;

В методе create() мы создаём экземпляр Graphics для рисования линий и фигур. Затем определяем объект follower. Его свойство `t(от 0 до 1) указывает позицию на кривой, аvec` — вектор для хранения вычисленных координат этой позиции.

create ()
    {
        this.graphics = this.add.graphics();
        this.follower = { t: 0, vec: new Phaser.Math.Vector2() };

Создание и конфигурация пути (Path)

Класс Phaser.Curves.Path является контейнером для одной или нескольких кривых. В данном примере мы добавляем в него одну кривую — эллипс. Конструктор Ellipse принимает координаты центра (x, y) и радиус.

this.path = new Phaser.Curves.Path();
        this.path.add(new Phaser.Curves.Ellipse(400, 300, 100));

Для анимации движения объекта follower по пути используется твин. Он плавно изменяет свойство `tобъектаfollowerот 0 до 1 за 4 секунды. Параметрыyoyo: trueиrepeat: -1` заставляют анимацию проигрываться в прямом и обратном направлении бесконечно.

this.tweens.add({
            targets: this.follower,
            t: 1,
            ease: 'Sine.easeInOut',
            duration: 4000,
            yoyo: true,
            repeat: -1
        });

Визуализация пути и объекта-последователя

Метод update() вызывается каждый кадр. Первым делом мы очищаем холст Graphics от рисования предыдущего кадра, чтобы рисовать актуальную картину.

update ()
    {
        this.graphics.clear();
        this.graphics.lineStyle(2, 0xffffff, 1);

Затем рисуем сам путь (эллипс) белой линией толщиной 2 пикселя.

this.path.draw(this.graphics);

Ключевой метод getPoint вычисляет координаты точки на кривой для заданного значения `t(от 0 до 1) и записывает результат в переданный векторthis.follower.vec`.

this.path.getPoint(this.follower.t, this.follower.vec);

Наконец, в полученных координатах мы рисуем красный кружок, который и представляет собой движущийся объект.

this.graphics.fillStyle(0xff0000, 1);
        this.graphics.fillCircle(this.follower.vec.x, this.follower.vec.y, 12);
    }

Конфигурация и запуск игры

Стандартная конфигурация игры Phaser. Важно, что в свойстве scene указан наш класс Example. Это делает его активной сценой при запуске.

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

const game = new Phaser.Game(config);

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

Связка Path, твина и объекта-последователя создаёт мощную и простую систему для движения по сложным траекториям. Для экспериментов попробуйте

1. Заменить Ellipse на Line, Spline или Circle
2. Добавить в Path несколько кривых подряд для создания составного пути
3. Привязать к координатам follower.vec спрайт игрока или врага вместо графического круга
4. Изменить параметры твина (easing, duration) для получения разного характера движения