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 |

Что 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 объектов с тенями.

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

Первая сцена в несколько строк
Нужны всего два пакета: 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 для отражения.

Персонажей из кубиков никто не собирает. Художники экспортируют модели из программ вроде 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 и туман. Любопытно, что игра рисует графику и создаёт музыку кодом, поэтому не загружает ни одного файла с картинками или звуком.

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

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

- С умом используйте ИИ-ассистента. Команда выпускает 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.




