PixiJS 3D é um motor 3D novo e gratuito da equipe do PixiJS que roda no mesmo palco (stage) dos seus sprites 2D. Ele entrou em beta aberto em 12 de novembro de 2026, usa WebGPU em primeiro lugar com WebGL2 como alternativa e tem licença MIT. Se você sabe um pouco de JavaScript, já dá para colocar hoje uma cena 3D com luz e sombra numa página web; e se você só quer jogar, dois jogos grátis feitos com ele já rodam no navegador.
Este guia mostra as poucas ideias que formam qualquer cena 3D, o código mínimo para montar a sua e os jogos e exemplos que valem a pena testar.
PixiJS 3D em resumo
| O que é | Uma extensão 3D para o PixiJS, publicada no npm como @pixi/3d |
| Quem faz | A equipe do PixiJS |
| Situação | Beta aberto desde 12 de novembro de 2026; a API ainda pode mudar antes da 1.0 |
| Preço e licença | Grátis, licença MIT |
| Renderização | WebGPU primeiro; o mesmo código roda em WebGL2 |
| Requisito | pixi.js 8.23.0 ou mais recente |
| Material de estudo | 35 guias, mais de 100 exemplos ao vivo e 3 tutoriais num editor ao vivo |
| Jogos para testar | Nightward e Mach 2 no site oficial Good Stuff |

O que o PixiJS 3D acrescenta ao PixiJS
O PixiJS é há muito tempo um dos renderizadores 2D mais populares para jogos web. O novo pacote não o substitui nem é um segundo motor rodando ao lado. Uma cena 3D fica dentro de um View3D, e um View3D é simplesmente um objeto de exibição, como um sprite. Você o adiciona ao stage, posiciona, define o tamanho, e o seu 2D pode ficar na frente ou atrás dele.
Esse design abre várias possibilidades:
- Um troféu ou personagem 3D girando dentro de um menu ou loja que é todo em 2D.
- Um jogo 3D em tela cheia com HUD, menus e botões de toque desenhados por cima em PixiJS 2D comum, sem uma camada HTML separada para manter sincronizada.
- Várias janelas
View3Dna mesma cena 2D, cada uma com sua própria câmera. - Um contêiner 2D desenhado ao vivo sobre uma superfície 3D, como a tela de um monitor 3D.
Filtros e máscaras funcionam numa vista 3D, objetos 3D recebem os mesmos eventos de ponteiro que os sprites e modelos glTF são carregados pelo mesmo carregador Assets que você usa para imagens.
A equipe também afirma que o motor é “rápido por padrão”. Malhas que compartilham uma geometria e um material são desenhadas numa única chamada instanciada, sem você precisar pedir. Na maioria dos navegadores com WebGPU, o culling roda num compute shader; no Safari e no iPhone ou iPad, ele roda na CPU em cenas comuns. Só as malhas que mudaram são atualizadas, então uma cena parada gasta pouca CPU. Para florestas ou multidões, o BatchedMesh3D desenha quantidades enormes de cópias, e a demo oficial mostra 100.000 objetos com sombras.

As 6 peças básicas de uma cena 3D
O tutorial oficial “3D 101” divide o 3D em ideias pequenas, empilhadas umas sobre as outras. Aprenda nesta ordem e o resto da documentação fica bem mais fácil de ler.
- Espaço. Uma posição 2D tem x e y; o 3D acrescenta z. No PixiJS 3D, x aponta para a direita, y para cima e z sai da tela em direção a você. Atenção: y aponta para cima, o contrário do PixiJS 2D.
0, 0, 0é a origem, e uma unidade equivale a um metro, por isso os números são pequenos. - Triângulos. Toda forma é feita de triângulos. Um ponto é um vértice, três vértices formam um triângulo, um cubo precisa de 12 triângulos e uma esfera lisa de cerca de mil. A lista de vértices e triângulos é a geometria: só forma, sem cor.
- Malha = geometria + material. O material diz do que a coisa é feita. Junte os dois e você tem uma malha (mesh), o objeto que vai para a cena. O PixiJS 3D já cria nove formas comuns para você, incluindo cubo, esfera, cone e toro.
- Transformações. Todo objeto tem posição, rotação e escala, agora cada uma com z. As rotações são em radianos (
Math.PIé meia volta), ou useanglepara graus. UmContainer3Dagrupa objetos para que, ao girar o pai, os filhos girem junto: é assim que se monta um planeta com sua lua. - Câmera. Cada vista tem uma câmera que começa na origem, então o primeiro passo é afastá-la. O campo de visão (
fov) é de 60 graus por padrão. AOrbitCameradeixa o jogador arrastar para girar em volta de um alvo. - Luz e sombra. Sem luz, um
Material3Dfica preto. UmaDirectionalLightfunciona como o sol, umaPointLightcomo uma lâmpada e umaSpotLightcomo uma lanterna. AtivecastShadownuma luz direcional ou spot e as malhas projetam e recebem sombras; luzes pontuais não projetam sombras.

Sua primeira cena em poucas linhas
Você só precisa de dois pacotes: npm install pixi.js @pixi/3d. Depois crie um app, peça WebGPU (o PixiJS usa WebGL2 onde não houver suporte) e adicione uma vista:
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 });
Tudo do mundo 3D fica sob view3d.root, assim como os objetos 2D ficam sob app.stage. Vale lembrar duas armadilhas de iniciante: se não aparece nada, provavelmente a câmera ainda está dentro do seu objeto, na origem; e se o objeto está preto, você ainda não adicionou uma luz. Configurar view3d.environment com uma cor de céu e uma de chão ilumina os lados que o sol não alcança.
Para as sombras, defina sun.castShadow = true e adicione um chão feito com PlaneGeometry, deitado com rotation.x = -Math.PI / 2. O tutorial sugere desligar castShadow no chão grande para que o detalhe limitado de sombra do sol vá para os objetos pequenos e as sombras deles fiquem nítidas.
Materiais e modelos: deixando tudo com cara de real
Um Material3D só com cor parece giz, porque a rugosidade começa em 1. Dois números mudam tudo:
| Ajuste | Valor | Aparência |
|---|---|---|
roughness |
0 | Liso como espelho, brilhos nítidos |
roughness |
1 (padrão) | Totalmente áspero, como giz ou argila |
metallic |
0 | Não metal: plástico, madeira, pedra |
metallic |
1 | Metal que tinge os reflexos com a própria cor |
Ou seja, plástico rosa brilhante é uma cor com rugosidade 0,3; cromo é branco com metallic 1 e rugosidade 0,05; e ouro é uma cor dourada com metallic 1. Metais mostram principalmente o que está em volta, então ficam melhores com um ambiente para refletir.

Ninguém monta um personagem com cubos. Artistas exportam modelos de ferramentas como o Blender no formato glTF (.gltf ou .glb), um formato aberto que guarda malhas, materiais e animações. No PixiJS 3D você carrega o arquivo com Assets.load, coloca dentro de um Model3D e toca uma das animações que vieram com ele usando autoPlay. Os modelos mantêm o tamanho em que foram criados, então meça e ajuste a escala antes de posicioná-los. Quando o modelo é a cena inteira, View3D.from(source) cria uma vista com câmera e luz já prontas.
Além do básico, o motor inclui skinning, morph targets, texturas comprimidas, materiais PBR, Phong, flat e toon, HDR, tone mapping, pós-processamento, partículas e sombras em cascata.
Dois jogos grátis feitos com PixiJS 3D
A equipe do PixiJS criou dois jogos com o motor e os colocou no site Good Stuff, onde dá para jogar de graça no navegador.
Nightward é um jogo de sobrevivência num cemitério iluminado pela lua. Você só se movimenta: seis armas atiram sozinhas enquanto a horda cresce, até que o Grave Reaper sai da cripta. Os sprites em pixel art ficam numa cena 3D como billboards iluminados que projetam sombras, com bloom, tilt-shift e neblina por cima. O mais curioso: o jogo desenha a arte e cria a música em código, então não carrega nenhum arquivo de imagem ou de áudio.

Mach 2 é um runner num half-pipe. Você gira em volta do tubo, pula e coleta cubos ao longo de cinco zonas, com um HUD 2D sobre a corrida. Roda em WebGPU ou WebGL2, no teclado ou no celular.
Dicas rápidas para jogar:
- Em Nightward, ande em círculos largos; ficar parado deixa a horda fechar o cerco, e suas armas precisam de espaço para funcionar.
- Em Mach 2, use toda a curva do tubo para alinhar os cubos antes de pular.
- Se o jogo travar, feche outras abas pesadas e confira se a aceleração de hardware está ativada nas configurações do navegador.

Próximos passos para quem desenvolve jogos web
- Comece pequeno. Siga o quick start oficial, depois copie um exemplo e mude um número de cada vez. Todo exemplo da galeria vem com o código-fonte.
- Teste os tutoriais. Três projetos rodam num editor ao vivo: formas flutuantes, uma vitrine de modelos e uma galeria de tiro que monta um joguinho passo a passo.
- Leia um jogo completo. O jogo de corrida dos exemplos mostra como um projeto inteiro se encaixa.

- Use um agente de IA com sabedoria. A equipe publica uma skill
pixijs-3dpara agentes como Claude Code, Cursor, Codex e Copilot, instalada comnpx skills add https://github.com/pixijs/pixijs-skills. Ela lista os erros que não disparam exceção, mas desenham a imagem errada. - Lembre que é um beta. Os testadores do beta fechado enviaram mais de 30 relatos de bugs e pedidos de recursos antes do lançamento, e a API ainda pode mudar antes da 1.0. Fixe sua versão e leia as notas de lançamento antes de atualizar.
Links oficiais úteis: o anúncio do PixiJS 3D, o tutorial 3D 101, a galeria de exemplos e os jogos do Good Stuff.
Perguntas frequentes
O PixiJS 3D é grátis?
Sim. O PixiJS 3D tem licença MIT, e a equipe diz que sempre terá. Você pode usá-lo em projetos gratuitos e comerciais.
Preciso de WebGPU para usar o PixiJS 3D?
Não. Ele foi projetado em torno do WebGPU, mas o mesmo código roda em WebGL2, e cada navegador baixa apenas o backend que usa.
Dá para misturar 2D e 3D num mesmo jogo PixiJS?
Sim. Um View3D é um objeto de exibição, então você pode colocar cenas 3D dentro de um stage 2D, desenhar interface 2D sobre o 3D e até desenhar contêineres 2D em superfícies 3D.
Qual versão do PixiJS ele exige?
O @pixi/3d exige pixi.js 8.23.0 ou mais recente e deve ser importado antes de app.init rodar.
Ele carrega modelos do Blender?
Sim. Exporte o modelo como glTF (.gltf ou .glb), carregue com Assets.load e exiba com Model3D, incluindo as animações.
Onde jogar jogos feitos com PixiJS 3D?
Nightward e Mach 2 podem ser jogados de graça no navegador, no site oficial Good Stuff, goodstuff.pixijs.io.




