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

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

При создании игр на Phaser с физикой Matter.js иногда нужно отключить гравитацию для определённых объектов или всей сцены. Это полезно для космических симуляторов, головоломок с плавающими элементами или интерфейсов с инерцией. В этой статье разберём базовый пример, где физический мир существует без силы тяжести, и объект остаётся неподвижным в воздухе.

Версия 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('block', 'assets/sprites/block.png');
        this.load.image('platform', 'assets/sprites/platform.png');
    }

    create ()
    {
        this.matter.add.image(400, 300, 'block');
    }
}

const config = {
    type: Phaser.AUTO,
    width: 800,
    height: 600,
    backgroundColor: '#1b1464',
    parent: 'phaser-example',
    physics: {
        default: 'matter',
        matter: {
            gravity: {
                x: 0,
                y: 0
            }
        }
    },
    scene: Example
};

const game = new Phaser.Game(config);

Настройка физики Matter.js

Вся конфигурация физического движка Matter.js в Phaser задаётся в объекте config. Ключевой параметр — gravity, который управляет силой тяжести по осям X и Y.

physics: {
    default: 'matter',
    matter: {
        gravity: {
            x: 0,
            y: 0
        }
    }
}

Здесь gravity.x и gravity.y установлены в `0`. Это означает, что на все физические тела в сцене не действует сила притяжения. Движок будет рассчитывать столкновения и другие свойства, но не будет автоматически сдвигать объекты вниз или в сторону.

Создание физического спрайта

В методе create() сцены мы добавляем физический объект — спрайт блока. Для этого используется фабрика this.matter.add.image.

this.matter.add.image(400, 300, 'block');

Эта строка создаёт изображение с ключом 'block' в координатах (400, 300) и сразу наделяет его физическим телом Matter.js. Поскольку гравитация отключена, блок останется висеть в этой точке. Если бы гравитация была активна (например, y: 1), блок начал бы падать.

Загрузка ресурсов и структура сцены

Как и в любой сцене Phaser, мы предварительно загружаем изображения в preload(). В этом примере загружаются два спрайта, но используется только один.

preload ()
{
    this.load.setBaseURL('https://raw.githubusercontent.com/phaserjs/examples/master/public/');
    this.load.image('block', 'assets/sprites/block.png');
    this.load.image('platform', 'assets/sprites/platform.png');
}

Метод setBaseURL задаёт базовый URL для загрузки, что удобно для примеров. В реальном проекте вы, скорее всего, будете использовать локальные пути. Обратите внимание: спрайт 'platform' загружен, но не используется в коде — это просто демонстрация.

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

Отключение гравитации в Matter.js — простой, но мощный приём. Он открывает возможности для нестандартной физики. Попробуйте поэкспериментировать: добавьте несколько блоков и примените к ним силу с помощью body.applyForce(), создайте управляемый корабль в невесомости или постройте статичную механическую конструкцию, которая активируется только по клику.