Saltar al contenido

PixiJS 3D explicado: guía para principiantes de juegos 3D en el navegador, y 2 juegos gratis para probar

abe ·

PixiJS 3D suma un motor 3D completo a PixiJS, gratis y con licencia MIT. Te contamos de qué está hecha una escena 3D, cómo crear la primera y dos juegos gratis hechos con él.

Portada VENO: una isla 3D renderizada con PixiJS 3D y el título PixiJS 3D, 3D en la web

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

Una pequeña isla 3D con pinos, una cabaña roja y un estanque, renderizada en tiempo real por PixiJS 3D en el navegador de ejemplos oficial, imagen: PixiJS

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

Un anillo enorme formado por muchos objetos pequeños de colores dibujados con BatchedMesh3D en un ejemplo de PixiJS 3D, imagen: PixiJS

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.

  1. 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, 0 es el origen, y una unidad equivale a un metro, por eso los números son pequeños.
  2. 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.
  3. 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.
  4. Transformaciones. Cada objeto tiene posición, rotación y escala, ahora cada una con z. Las rotaciones van en radianes (Math.PI es media vuelta), o usa angle para grados. Un Container3D agrupa objetos para que al girar el padre giren los hijos: así se construye un planeta con su luna.
  5. 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. OrbitCamera permite arrastrar para girar alrededor de un objetivo.
  6. Luz y sombra. Sin luz, un Material3D se ve negro. Una DirectionalLight funciona como el sol, una PointLight como una bombilla y una SpotLight como una linterna. Activa castShadow en una luz direccional o de foco y las mallas proyectan y reciben sombras; las luces puntuales no proyectan sombras.

Las nueve formas 3D integradas en PixiJS 3D, como esfera, toro, cono, cubo y nudo, cada una con material de arcilla, imagen: PixiJS

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.

Una cuadrícula de esferas de lisas a rugosas y de plástico a metal reflejando un atardecer en PixiJS 3D, imagen: PixiJS

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.

Partida de Nightward con un héroe en pixel art luchando contra una horda creciente en un cementerio 3D a la luz de la luna, imagen: PixiJS

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:

  1. En Nightward, muévete en círculos amplios; si te quedas quieto, la horda te rodea y tus armas necesitan espacio para trabajar.
  2. En Mach 2, aprovecha toda la curva del tubo para alinear los cubos antes de saltar.
  3. 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.

Mach 2, un runner de half-pipe en tonos rosas hecho con PixiJS 3D, funcionando en un navegador de escritorio, imagen: PixiJS

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.

El ejemplo oficial de carreras de PixiJS 3D con un coche amarillo en la pista, pinos y un arco naranja, imagen: PixiJS

  • Usa bien un agente de IA para programar. El equipo publica una skill pixijs-3d para agentes como Claude Code, Cursor, Codex y Copilot, que se instala con npx 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.

Artículos relacionados

Cargando juego…

VENOGAME / PLAYBOOK

Mi arena

Guardado en este dispositivo. Sin cuenta.

Toca un corazón y crea tu colección de juegos.