Перейти к содержимому

Что такое PixiJS 3D: руководство для начинающих по 3D-играм в браузере и 2 бесплатные игры

abe ·

PixiJS 3D добавляет в PixiJS полноценный 3D-движок, бесплатный по лицензии MIT. Разбираем, из чего состоит 3D-сцена, как собрать первую и во что уже можно поиграть.

Обложка VENO: 3D-остров, отрисованный PixiJS 3D, с заголовком PixiJS 3D, 3D в браузере

PixiJS 3D — новый бесплатный 3D-движок от команды PixiJS, который работает на той же сцене (stage), что и ваши 2D-спрайты. Открытая бета стартовала 12 ноября 2026 года; движок в первую очередь рассчитан на WebGPU, умеет переключаться на WebGL2 и распространяется по лицензии MIT. Если вы хоть немного знаете JavaScript, уже сегодня можно разместить на веб-странице 3D-сцену со светом и тенями. А если хочется просто поиграть, две бесплатные игры на этом движке уже запускаются прямо в браузере.

В этом руководстве — несколько идей, из которых складывается любая 3D-сцена, минимальный код для первой сцены и ссылки на игры и примеры, которые стоит попробовать.

PixiJS 3D коротко

Что это 3D-расширение для PixiJS, пакет @pixi/3d в npm
Разработчик Команда PixiJS
Статус Открытая бета с 12 ноября 2026 года; до версии 1.0 API ещё может меняться
Цена и лицензия Бесплатно, лицензия MIT
Рендеринг Сначала WebGPU, тот же код работает на WebGL2
Требование pixi.js версии 8.23.0 или новее
Учебные материалы 35 руководств, более 100 интерактивных примеров, 3 урока в живом редакторе
Во что поиграть Nightward и Mach 2 на официальном сайте Good Stuff

Небольшой 3D-остров с соснами, красным домиком и прудом, отрисованный PixiJS 3D в официальной галерее примеров, изображение: PixiJS

Что PixiJS 3D добавляет к PixiJS

PixiJS давно входит в число самых популярных 2D-рендереров для браузерных игр. Новый пакет не заменяет его и не является вторым движком, работающим рядом. 3D-сцена живёт внутри View3D, а View3D — обычный display object, как спрайт. Его добавляют на stage, задают положение и размер, а 2D-элементы могут находиться перед ним или за ним.

Такой подход открывает много вариантов:

  • Вращающийся 3D-кубок или персонаж в меню или магазине, которые в остальном сделаны в 2D.
  • Полноэкранная 3D-игра, где HUD, меню и сенсорные кнопки нарисованы обычным PixiJS 2D поверх, без отдельного HTML-слоя, который нужно синхронизировать.
  • Несколько окон View3D в одной 2D-сцене, у каждого своя камера.
  • 2D-контейнер, который в реальном времени рисуется на 3D-поверхности, например на экране 3D-монитора.

Фильтры и маски работают с 3D-видом, 3D-объекты получают те же события указателя, что и спрайты, а модели glTF загружаются через тот же загрузчик Assets, что и картинки.

Команда также говорит, что движок «быстрый по умолчанию». Меши с общей геометрией и общим материалом рисуются одним инстансированным вызовом, даже если вы этого не просили. В большинстве браузеров с WebGPU отсечение невидимых объектов (culling) выполняется в вычислительном шейдере, а в Safari и на iPhone или iPad для типичных сцен — на процессоре. Обновляются только изменившиеся меши, поэтому неподвижная сцена почти не нагружает CPU. Для лесов и толп BatchedMesh3D рисует огромное число копий, а официальное демо показывает 100 000 объектов с тенями.

Огромное кольцо из множества маленьких разноцветных объектов, нарисованное BatchedMesh3D в примере PixiJS 3D, изображение: PixiJS

6 кирпичиков 3D-сцены

Официальный урок «3D 101» раскладывает 3D на маленькие идеи, которые надстраиваются друг на друга. Изучайте их в таком порядке, и остальная документация станет гораздо понятнее.

  1. Пространство. У позиции в 2D есть x и y, в 3D добавляется z. В PixiJS 3D ось x направлена вправо, y — вверх, а z — из экрана к вам. Обратите внимание: y смотрит вверх, в отличие от PixiJS 2D. 0, 0, 0 — начало координат, а одна единица задумана как один метр, поэтому числа остаются небольшими.
  2. Треугольники. Любая форма состоит из треугольников. Точка называется вершиной (vertex), три вершины дают треугольник, кубу нужно 12 треугольников, а гладкому шару — около тысячи. Список вершин и треугольников — это геометрия: только форма, без цвета.
  3. Меш = геометрия + материал. Материал определяет, из чего сделан предмет. Вместе они образуют меш — объект, который добавляют в сцену. PixiJS 3D сам строит девять распространённых форм, среди них куб, сфера, конус и тор.
  4. Трансформации. У каждого объекта есть позиция, поворот и масштаб, теперь с осью z. Повороты задаются в радианах (Math.PI — пол-оборота) или в градусах через angle. Container3D группирует объекты: поворачиваете родителя — поворачиваются и дети. Так собирают планету с луной.
  5. Камера. У каждого вида есть камера, которая стартует в начале координат, поэтому первым делом её отодвигают назад. Поле зрения (fov) по умолчанию — 60 градусов. OrbitCamera позволяет игроку перетаскиванием вращать камеру вокруг цели.
  6. Свет и тени. Без света Material3D рисуется чёрным. DirectionalLight работает как солнце, PointLight — как лампочка, SpotLight — как фонарик. Включите castShadow у направленного или прожекторного источника, и меши будут отбрасывать и принимать тени; точечные источники теней не дают.

Девять встроенных 3D-фигур PixiJS 3D, включая сферу, тор, конус, куб и узел, с глиняным материалом, изображение: PixiJS

Первая сцена в несколько строк

Нужны всего два пакета: npm install pixi.js @pixi/3d. Затем создайте приложение, запросите WebGPU (там, где его нет, PixiJS перейдёт на WebGL2) и добавьте вид:

import { View3D, Mesh3D, SphereGeometry, Material3D, DirectionalLight } from '@pixi/3d';
import { Application } from 'pixi.js';

const app = new Application();
await app.init({ preference: 'webgpu', resizeTo: window, antialias: true });
document.body.appendChild(app.canvas);

const view3d = new View3D({ autoResize: true });
app.stage.addChild(view3d);

const ball = new Mesh3D({
  geometry: new SphereGeometry({ radius: 0.5 }),
  material: new Material3D({ baseColor: 0xe91e63 }),
});
ball.position.y = 0.5;
view3d.root.addChild(ball);

view3d.camera.position.set(0, 2, 5);
view3d.camera.lookAt(ball.position);

const sun = new DirectionalLight({ color: 0xfff4e0, intensity: 3 });
sun.position.set(-3, 5, 2);
view3d.root.addChild(sun);
sun.lookAt({ x: 0, y: 0, z: 0 });

Всё в 3D-мире кладётся в view3d.root, так же как 2D-объекты — в app.stage. Запомните две ловушки новичков: если на экране пусто, скорее всего камера всё ещё стоит внутри объекта в начале координат; если объект чёрный — вы ещё не добавили свет. Свойство view3d.environment с цветом неба и цветом земли подсвечивает стороны, до которых не достаёт солнце.

Для теней задайте sun.castShadow = true и добавьте пол из PlaneGeometry, уложенный горизонтально через rotation.x = -Math.PI / 2. Урок советует отключить castShadow у большого пола, чтобы ограниченная детализация теней от солнца досталась мелким объектам и их тени оставались чёткими.

Материалы и модели: как сделать объекты реалистичнее

Material3D, которому задан только цвет, выглядит как мел, потому что шероховатость по умолчанию равна 1. Всё меняют два числа:

Параметр Значение Как выглядит
roughness 0 Гладко, как зеркало, с резкими бликами
roughness 1 (по умолчанию) Полностью шероховато, как мел или глина
metallic 0 Не металл: пластик, дерево, камень
metallic 1 Металл, окрашивающий отражения в свой цвет

Блестящий розовый пластик — это цвет с roughness 0.3, хром — белый с metallic 1 и roughness 0.05, а золото — золотой цвет с metallic 1. Металлы в основном показывают окружение, поэтому лучше всего смотрятся, когда есть environment для отражения.

Сетка шаров от гладких к шероховатым и от пластика к металлу, отражающих закат, в PixiJS 3D, изображение: PixiJS

Персонажей из кубиков никто не собирает. Художники экспортируют модели из программ вроде Blender в glTF (.gltf или .glb) — открытый формат, который хранит меши, материалы и анимации. В PixiJS 3D файл загружают через Assets.load, оборачивают в Model3D и запускают встроенную анимацию через autoPlay. Модель сохраняет размер, в котором её сделали, так что измерьте и отмасштабируйте её перед размещением. Если модель — это вся сцена, View3D.from(source) сразу создаёт вид с камерой и светом.

Помимо основ, в движке есть скиннинг, morph targets, сжатые текстуры, материалы PBR, Phong, flat и toon, HDR, тональная компрессия (tone mapping), постобработка, частицы и каскадные тени.

Две бесплатные игры на PixiJS 3D

Команда PixiJS сделала на движке две игры и выложила их на сайт Good Stuff, где в них можно бесплатно поиграть в браузере.

Nightward — игра на выживание на кладбище в лунном свете. Вы только двигаетесь: шесть видов оружия стреляют сами, пока орда растёт, а потом из склепа поднимается Grave Reaper. Пиксельные спрайты стоят в 3D-сцене как освещённые билборды, отбрасывающие тени, поверх — свечение (bloom), tilt-shift и туман. Любопытно, что игра рисует графику и создаёт музыку кодом, поэтому не загружает ни одного файла с картинками или звуком.

Игровой процесс Nightward: пиксельный герой сражается с растущей ордой на 3D-кладбище в лунном свете, изображение: PixiJS

Mach 2 — раннер в трубе-хафпайпе. Вы двигаетесь по кругу внутри трубы, прыгаете и собираете кубы в пяти зонах, а поверх забега отображается 2D-HUD. Игра работает на WebGPU или WebGL2, с клавиатуры или на телефоне.

Короткие советы игрокам:

  1. В Nightward постоянно двигайтесь широкими кругами: если стоять на месте, орда подойдёт вплотную, а оружию нужно пространство.
  2. В Mach 2 используйте весь изгиб трубы, чтобы выстроиться под кубы до прыжка.
  3. Если игра подтормаживает, закройте другие тяжёлые вкладки и проверьте, что в настройках браузера включено аппаратное ускорение.

Mach 2 — розовый раннер в трубе на PixiJS 3D, запущенный в браузере на компьютере, изображение: PixiJS

Что дальше для разработчика браузерных игр

  • Начните с малого. Пройдите официальный quick start, затем скопируйте один пример и меняйте по одному числу за раз. У каждого примера в галерее есть исходный код.
  • Попробуйте уроки. Три проекта работают в живом редакторе: летающие фигуры, витрина моделей и тир (shooting gallery), где шаг за шагом собирается небольшая игра.
  • Разберите готовую игру. Гоночная игра в примерах показывает, как устроен целый проект.

Официальный гоночный пример PixiJS 3D: жёлтая машина на трассе, сосны и оранжевая арка, изображение: PixiJS

  • С умом используйте ИИ-ассистента. Команда выпускает skill pixijs-3d для агентов вроде Claude Code, Cursor, Codex и Copilot; он устанавливается командой npx skills add https://github.com/pixijs/pixijs-skills. В нём перечислены ошибки, которые не выдают сообщений, но рисуют не ту картинку.
  • Помните, что это бета. Участники закрытой беты прислали более 30 отчётов об ошибках и пожеланий до запуска, а API ещё может измениться до версии 1.0. Фиксируйте версию и читайте заметки к релизам перед обновлением.

Полезные официальные ссылки: анонс PixiJS 3D, урок 3D 101, галерея примеров и игры на Good Stuff.

Частые вопросы

PixiJS 3D бесплатный?

Да. PixiJS 3D распространяется по лицензии MIT, и команда говорит, что так будет всегда. Его можно использовать и в бесплатных, и в коммерческих проектах.

Нужен ли WebGPU, чтобы пользоваться PixiJS 3D?

Нет. Движок спроектирован вокруг WebGPU, но тот же код работает на WebGL2, а каждый браузер загружает только нужный ему бэкенд.

Можно ли смешивать 2D и 3D в одной игре на PixiJS?

Да. View3D — это display object, поэтому 3D-сцены можно размещать на 2D-сцене, рисовать 2D-интерфейс поверх 3D и даже выводить 2D-контейнеры на 3D-поверхности.

Какая версия PixiJS нужна?

@pixi/3d требует pixi.js 8.23.0 или новее, и импортировать его нужно до запуска app.init.

Можно ли загружать модели из Blender?

Да. Экспортируйте модель в glTF (.gltf или .glb), загрузите через Assets.load и покажите с помощью Model3D вместе с анимациями.

Где поиграть в игры на PixiJS 3D?

Nightward и Mach 2 доступны бесплатно в браузере на официальном сайте Good Stuff — goodstuff.pixijs.io.

Похожие статьи

Загрузка игры…

VENOGAME / PLAYBOOK

Моя арена

На этом устройстве. Без регистрации.

Нажмите сердечко и соберите свою коллекцию.