PixiJS 3D es un motor 3D nuevo y gratuito del equipo de PixiJS que funciona en el mismo escenario (stage) que tus sprites 2D. Entró en beta abierta el 12 de noviembre de 2026, usa WebGPU como primera opción con WebGL2 como respaldo y tiene licencia MIT. Si sabes un poco de JavaScript, hoy mismo puedes poner una escena 3D con luces y sombras en una página web; y si solo quieres jugar, ya hay dos juegos gratis hechos con él que funcionan en tu navegador.
En esta guía verás las pocas ideas de las que está hecha cualquier escena 3D, el código mínimo para montar la tuya y los juegos y ejemplos que vale la pena probar.
PixiJS 3D de un vistazo
| Qué es | Una extensión 3D para PixiJS, publicada en npm como @pixi/3d |
| Quién lo hace | El equipo de PixiJS |
| Estado | Beta abierta desde el 12 de noviembre de 2026; la API aún puede cambiar antes de la 1.0 |
| Precio y licencia | Gratis, licencia MIT |
| Renderizado | WebGPU primero; el mismo código funciona en WebGL2 |
| Requisito | pixi.js 8.23.0 o superior |
| Material de aprendizaje | 35 guías, más de 100 ejemplos en vivo y 3 tutoriales en un editor en vivo |
| Juegos para probar | Nightward y Mach 2 en el sitio oficial Good Stuff |

Qué le aporta PixiJS 3D a PixiJS
PixiJS lleva años siendo uno de los renderizadores 2D más populares para juegos web. El nuevo paquete no lo sustituye ni es un segundo motor funcionando a su lado. Una escena 3D vive dentro de un View3D, y un View3D es simplemente un objeto de visualización, como un sprite. Lo añades al stage, lo colocas, le das tamaño, y tu 2D puede quedar delante o detrás.
Ese diseño abre muchas posibilidades:
- Un trofeo o un personaje 3D girando dentro de un menú o una tienda que por lo demás es 2D.
- Un juego 3D a pantalla completa con el HUD, los menús y los botones táctiles dibujados encima en PixiJS 2D normal, sin una capa HTML aparte que sincronizar.
- Varias ventanas
View3Den una misma escena 2D, cada una con su propia cámara. - Un contenedor 2D dibujado en vivo sobre una superficie 3D, como la pantalla de un monitor 3D.
Los filtros y las máscaras funcionan sobre una vista 3D, los objetos 3D reciben los mismos eventos de puntero que los sprites y los modelos glTF se cargan con el mismo cargador Assets que usas para las imágenes.
El equipo asegura además que el motor es “rápido por defecto”. Las mallas que comparten una geometría y un material se dibujan en una sola llamada instanciada sin que tengas que pedirlo. En la mayoría de navegadores con WebGPU, el culling se ejecuta en un compute shader; en Safari y en iPhone o iPad se hace en la CPU para escenas típicas. Solo se actualizan las mallas que cambian, así que una escena quieta apenas gasta CPU. Para bosques o multitudes, BatchedMesh3D dibuja enormes cantidades de copias, y la demo oficial muestra 100.000 objetos con sombras.

Las 6 piezas básicas de una escena 3D
El tutorial oficial “3D 101” divide el 3D en ideas pequeñas que se apilan unas sobre otras. Apréndelas en este orden y el resto de la documentación se vuelve mucho más fácil.
- Espacio. Una posición 2D tiene x e y; el 3D añade z. En PixiJS 3D, x apunta a la derecha, y hacia arriba y z sale de la pantalla hacia ti. Ojo: y apunta hacia arriba, al revés que en PixiJS 2D.
0, 0, 0es el origen, y una unidad equivale a un metro, por eso los números son pequeños. - Triángulos. Toda forma está hecha de triángulos. Un punto es un vértice, tres vértices forman un triángulo, un cubo necesita 12 triángulos y una esfera suave unos mil. La lista de vértices y triángulos es la geometría: solo forma, sin color.
- Malla = geometría + material. El material dice de qué está hecha una cosa. Junta ambos y obtienes una malla (mesh), el objeto que añades a la escena. PixiJS 3D trae nueve formas comunes ya hechas, entre ellas un cubo, una esfera, un cono y un toro.
- Transformaciones. Cada objeto tiene posición, rotación y escala, ahora cada una con z. Las rotaciones van en radianes (
Math.PIes media vuelta), o usaanglepara grados. UnContainer3Dagrupa objetos para que al girar el padre giren los hijos: así se construye un planeta con su luna. - Cámara. Cada vista tiene una cámara que empieza en el origen, así que lo primero es alejarla. Su campo de visión (
fov) es de 60 grados por defecto.OrbitCamerapermite arrastrar para girar alrededor de un objetivo. - Luz y sombra. Sin luz, un
Material3Dse ve negro. UnaDirectionalLightfunciona como el sol, unaPointLightcomo una bombilla y unaSpotLightcomo una linterna. ActivacastShadowen una luz direccional o de foco y las mallas proyectan y reciben sombras; las luces puntuales no proyectan sombras.

Tu primera escena en unas pocas líneas
Solo necesitas dos paquetes: npm install pixi.js @pixi/3d. Después crea una app, pide WebGPU (PixiJS usa WebGL2 donde no esté disponible) y añade una 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 });
Todo lo del mundo 3D va bajo view3d.root, igual que los objetos 2D van bajo app.stage. Hay dos trampas típicas de principiante: si no ves nada, probablemente la cámara sigue metida dentro de tu objeto en el origen; y si el objeto sale negro, todavía no has añadido una luz. Configurar view3d.environment con un color de cielo y otro de suelo rellena los lados que el sol no alcanza.
Para las sombras, pon sun.castShadow = true y añade un suelo hecho con PlaneGeometry, tumbado con rotation.x = -Math.PI / 2. El tutorial recomienda desactivar castShadow en el suelo grande para que el detalle limitado de sombra del sol se reparta entre los objetos pequeños y sus sombras queden nítidas.
Materiales y modelos: que todo parezca real
Un Material3D con solo un color parece tiza, porque la rugosidad empieza en 1. Dos números lo cambian todo:
| Ajuste | Valor | Aspecto |
|---|---|---|
roughness |
0 | Liso como un espejo, brillos nítidos |
roughness |
1 (por defecto) | Totalmente rugoso, como tiza o arcilla |
metallic |
0 | No metal: plástico, madera, piedra |
metallic |
1 | Metal que tiñe sus reflejos con su color |
Así, un plástico rosa brillante es un color con rugosidad 0,3; el cromo es blanco con metallic 1 y rugosidad 0,05; y el oro es un color dorado con metallic 1. Los metales muestran sobre todo lo que tienen alrededor, así que lucen mejor con un entorno que reflejar.

Nadie construye un personaje con cubos. Los artistas exportan modelos desde herramientas como Blender en formato glTF (.gltf o .glb), un formato abierto que puede guardar mallas, materiales y animaciones. En PixiJS 3D cargas el archivo con Assets.load, lo envuelves en un Model3D y reproduces una de sus animaciones con autoPlay. Los modelos conservan el tamaño con el que se crearon, así que mídelos y escálalos antes de colocarlos. Cuando un modelo es toda la escena, View3D.from(source) crea una vista con cámara y luz ya preparadas.
Más allá de lo básico, el motor incluye skinning, morph targets, texturas comprimidas, materiales PBR, Phong, planos y toon, HDR, tone mapping, posprocesado, partículas y sombras en cascada.
Dos juegos gratis hechos con PixiJS 3D
El equipo de PixiJS creó dos juegos con el motor y los publicó en su sitio Good Stuff, donde puedes jugarlos gratis en el navegador.
Nightward es un juego de supervivencia ambientado en un cementerio bajo la luz de la luna. Solo te mueves: seis armas disparan solas mientras la horda crece, hasta que el Grave Reaper sale de la cripta. Los sprites de pixel art están en una escena 3D como billboards iluminados que proyectan sombras, con bloom, tilt-shift y niebla por encima. Lo más curioso: el juego dibuja su arte y crea su música con código, así que no carga ningún archivo de imagen ni de audio.

Mach 2 es un runner en un half-pipe. Giras alrededor del tubo, saltas y recoges cubos a lo largo de cinco zonas, con un HUD 2D sobre la carrera. Funciona con WebGPU o WebGL2, con teclado o en el móvil.
Consejos rápidos para jugar:
- En Nightward, muévete en círculos amplios; si te quedas quieto, la horda te rodea y tus armas necesitan espacio para trabajar.
- En Mach 2, aprovecha toda la curva del tubo para alinear los cubos antes de saltar.
- Si un juego va a tirones, cierra otras pestañas pesadas y comprueba que la aceleración por hardware esté activada en la configuración del navegador.

Próximos pasos si desarrollas juegos web
- Empieza pequeño. Sigue el quick start oficial, luego copia un ejemplo y cambia un número cada vez. Todos los ejemplos de la galería incluyen su código fuente.
- Prueba los tutoriales. Hay tres proyectos en un editor en vivo: formas flotantes, un expositor de modelos y una galería de tiro que construye un pequeño juego paso a paso.
- Lee un juego completo. El juego de carreras de los ejemplos muestra cómo encaja un proyecto entero.

- Usa bien un agente de IA para programar. El equipo publica una skill
pixijs-3dpara agentes como Claude Code, Cursor, Codex y Copilot, que se instala connpx skills add https://github.com/pixijs/pixijs-skills. Recoge los errores que no lanzan ninguna excepción pero dibujan una imagen incorrecta. - Recuerda que es una beta. Los probadores de la beta cerrada enviaron más de 30 informes de errores y peticiones antes del lanzamiento, y la API aún puede cambiar antes de la 1.0. Fija tu versión y lee las notas de lanzamiento antes de actualizar.
Enlaces oficiales útiles: el anuncio de PixiJS 3D, el tutorial 3D 101, la galería de ejemplos y los juegos de Good Stuff.
Preguntas frecuentes
¿PixiJS 3D es gratis?
Sí. PixiJS 3D tiene licencia MIT, y el equipo dice que siempre la tendrá. Puedes usarlo en proyectos gratuitos y comerciales.
¿Necesito WebGPU para usar PixiJS 3D?
No. Está diseñado en torno a WebGPU, pero el mismo código funciona en WebGL2, y cada navegador descarga solo el backend que usa.
¿Puedo mezclar 2D y 3D en un mismo juego de PixiJS?
Sí. Un View3D es un objeto de visualización, así que puedes poner escenas 3D dentro de un stage 2D, dibujar interfaz 2D sobre el 3D e incluso dibujar contenedores 2D sobre superficies 3D.
¿Qué versión de PixiJS necesita?
@pixi/3d necesita pixi.js 8.23.0 o superior, y debe importarse antes de que se ejecute app.init.
¿Puede cargar modelos de Blender?
Sí. Exporta tu modelo como glTF (.gltf o .glb), cárgalo con Assets.load y muéstralo con Model3D, incluidas sus animaciones.
¿Dónde puedo jugar juegos hechos con PixiJS 3D?
Nightward y Mach 2 se pueden jugar gratis en el navegador en el sitio oficial Good Stuff, goodstuff.pixijs.io.




