Pular para o conteúdo

PixiJS 3D explicado: guia para iniciantes em jogos 3D no navegador, e 2 jogos grátis para jogar

abe ·

PixiJS 3D adiciona um motor 3D completo ao PixiJS, grátis e com licença MIT. Veja do que é feita uma cena 3D, como criar a sua primeira e dois jogos grátis feitos com ele.

Capa VENO: uma ilha 3D renderizada com PixiJS 3D e o título PixiJS 3D, 3D na web

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

Uma pequena ilha 3D com pinheiros, uma cabana vermelha e um lago, renderizada em tempo real pelo PixiJS 3D no navegador de exemplos oficial, imagem: PixiJS

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 View3D na 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.

Um anel enorme formado por muitos objetos pequenos e coloridos desenhados com BatchedMesh3D num exemplo do PixiJS 3D, imagem: PixiJS

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.

  1. 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.
  2. 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.
  3. 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.
  4. 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 use angle para graus. Um Container3D agrupa objetos para que, ao girar o pai, os filhos girem junto: é assim que se monta um planeta com sua lua.
  5. 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. A OrbitCamera deixa o jogador arrastar para girar em volta de um alvo.
  6. Luz e sombra. Sem luz, um Material3D fica preto. Uma DirectionalLight funciona como o sol, uma PointLight como uma lâmpada e uma SpotLight como uma lanterna. Ative castShadow numa luz direcional ou spot e as malhas projetam e recebem sombras; luzes pontuais não projetam sombras.

As nove formas 3D prontas do PixiJS 3D, como esfera, toro, cone, cubo e nó, cada uma com material de argila, imagem: PixiJS

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.

Uma grade de esferas indo do liso ao áspero e do plástico ao metal, refletindo um pôr do sol no PixiJS 3D, imagem: PixiJS

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.

Partida de Nightward com um herói em pixel art enfrentando uma horda crescente num cemitério 3D sob a lua, imagem: PixiJS

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:

  1. Em Nightward, ande em círculos largos; ficar parado deixa a horda fechar o cerco, e suas armas precisam de espaço para funcionar.
  2. Em Mach 2, use toda a curva do tubo para alinhar os cubos antes de pular.
  3. Se o jogo travar, feche outras abas pesadas e confira se a aceleração de hardware está ativada nas configurações do navegador.

Mach 2, um runner de half-pipe em tons de rosa feito com PixiJS 3D, rodando num navegador de computador, imagem: PixiJS

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.

O exemplo oficial de corrida do PixiJS 3D com um carro amarelo na pista, pinheiros e um arco laranja, imagem: PixiJS

  • Use um agente de IA com sabedoria. A equipe publica uma skill pixijs-3d para agentes como Claude Code, Cursor, Codex e Copilot, instalada com npx 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.

Artigos relacionados

Carregando jogo…

VENOGAME / PLAYBOOK

Minha arena

Salvo neste dispositivo. Sem conta.

Toque em um coração e crie sua coleção.