PixiJS 3D est un nouveau moteur 3D gratuit signé par l’équipe PixiJS, qui tourne sur la même scène (stage) que vos sprites 2D. Il est passé en bêta ouverte le 12 novembre 2026, s’appuie d’abord sur WebGPU avec WebGL2 en secours, et il est sous licence MIT. Avec un peu de JavaScript, vous pouvez dès aujourd’hui afficher une scène 3D éclairée et ombrée dans une page web ; et si vous voulez seulement jouer, deux jeux gratuits créés avec lui tournent déjà dans le navigateur.
Ce guide présente les quelques notions qui composent toute scène 3D, le code minimal pour créer la vôtre, et les jeux et exemples qui valent le détour.
PixiJS 3D en bref
| Ce que c’est | Une extension 3D pour PixiJS, publiée sur npm sous le nom @pixi/3d |
| Créé par | L’équipe PixiJS |
| Statut | Bêta ouverte depuis le 12 novembre 2026 ; l’API peut encore changer avant la 1.0 |
| Prix et licence | Gratuit, licence MIT |
| Rendu | WebGPU d’abord, le même code tourne sur WebGL2 |
| Prérequis | pixi.js 8.23.0 ou plus récent |
| Ressources | 35 guides, plus de 100 exemples en direct, 3 tutoriels dans un éditeur en ligne |
| Jeux à essayer | Nightward et Mach 2 sur le site officiel Good Stuff |

Ce que PixiJS 3D apporte à PixiJS
PixiJS compte depuis longtemps parmi les moteurs de rendu 2D les plus utilisés pour les jeux web. Le nouveau paquet ne le remplace pas et ne fait pas tourner un second moteur à côté. Une scène 3D vit dans un View3D, et un View3D est tout simplement un objet d’affichage, comme un sprite. Vous l’ajoutez au stage, vous le placez, vous le dimensionnez, et votre 2D peut passer devant ou derrière.
Cette approche ouvre de nombreux usages :
- Un trophée ou un personnage 3D qui tourne dans un menu ou une boutique entièrement en 2D.
- Un jeu 3D plein écran avec le HUD, les menus et les boutons tactiles dessinés par-dessus en PixiJS 2D classique, sans calque HTML séparé à synchroniser.
- Plusieurs fenêtres
View3Ddans une même scène 2D, chacune avec sa propre caméra. - Un conteneur 2D dessiné en direct sur une surface 3D, comme l’écran d’un moniteur en 3D.
Les filtres et masques fonctionnent sur une vue 3D, les objets 3D reçoivent les mêmes événements de pointeur que les sprites, et les modèles glTF se chargent avec le même chargeur Assets que vos images.
L’équipe affirme aussi que le moteur est « rapide par défaut ». Les maillages qui partagent une géométrie et un matériau sont dessinés en un seul appel instancié, sans rien demander. Sur la plupart des navigateurs WebGPU, le culling tourne dans un compute shader ; dans Safari et sur iPhone ou iPad, il passe par le CPU pour les scènes courantes. Seuls les maillages modifiés sont mis à jour, donc une scène immobile coûte très peu au CPU. Pour les forêts ou les foules, BatchedMesh3D dessine d’énormes quantités de copies, et la démo officielle affiche 100 000 objets avec ombres.

Les 6 briques d’une scène 3D
Le tutoriel officiel « 3D 101 » découpe la 3D en petites idées empilées les unes sur les autres. Apprenez-les dans cet ordre et le reste de la documentation devient bien plus facile à lire.
- L’espace. Une position 2D a un x et un y ; la 3D ajoute z. Dans PixiJS 3D, x pointe vers la droite, y vers le haut et z sort de l’écran vers vous. Attention : y pointe vers le haut, à l’inverse de PixiJS 2D.
0, 0, 0est l’origine, et une unité vaut un mètre, d’où des nombres petits. - Les triangles. Toute forme est faite de triangles. Un point est un sommet (vertex), trois sommets forment un triangle, un cube demande 12 triangles et une sphère lisse environ un millier. La liste des sommets et des triangles, c’est la géométrie : la forme seule, sans couleur.
- Maillage = géométrie + matériau. Le matériau dit de quoi l’objet est fait. Réunissez les deux et vous obtenez un maillage (mesh), l’objet que vous ajoutez à la scène. PixiJS 3D fournit neuf formes courantes, dont un cube, une sphère, un cône et un tore.
- Les transformations. Chaque objet a une position, une rotation et une échelle, chacune avec désormais un z. Les rotations sont en radians (
Math.PIfait un demi-tour), ou utilisezanglepour les degrés. UnContainer3Dregroupe des objets : tourner le parent fait tourner les enfants, c’est ainsi qu’on construit une planète et sa lune. - La caméra. Chaque vue a une caméra qui démarre à l’origine : il faut donc d’abord la reculer. Son champ de vision (
fov) vaut 60 degrés par défaut.OrbitCamerapermet au joueur de faire glisser pour tourner autour d’une cible. - Lumière et ombre. Sans lumière, un
Material3Ds’affiche en noir. UneDirectionalLightagit comme le soleil, unePointLightcomme une ampoule et uneSpotLightcomme une lampe torche. ActivezcastShadowsur une lumière directionnelle ou un spot et les maillages projettent et reçoivent des ombres ; les lumières ponctuelles n’en projettent pas.

Votre première scène en quelques lignes
Deux paquets suffisent : npm install pixi.js @pixi/3d. Créez ensuite une application, demandez WebGPU (PixiJS bascule sur WebGL2 quand il manque) et ajoutez une vue :
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 });
Tout ce qui appartient au monde 3D va sous view3d.root, comme les objets 2D vont sous app.stage. Deux pièges de débutant à retenir : si vous ne voyez rien, la caméra est sans doute encore à l’intérieur de votre objet, à l’origine ; si l’objet est noir, vous n’avez pas encore ajouté de lumière. Définir view3d.environment avec une couleur de ciel et une couleur de sol éclaire les côtés que le soleil n’atteint pas.
Pour les ombres, passez sun.castShadow = true et ajoutez un sol fait d’une PlaneGeometry, couchée à plat avec rotation.x = -Math.PI / 2. Le tutoriel conseille de désactiver castShadow sur ce grand sol pour que le détail d’ombre limité du soleil aille aux petits objets, dont les ombres restent alors nettes.
Matériaux et modèles : rendre les objets réalistes
Un Material3D qui n’a qu’une couleur ressemble à de la craie, car la rugosité démarre à 1. Deux nombres changent tout :
| Réglage | Valeur | Rendu |
|---|---|---|
roughness |
0 | Lisse comme un miroir, reflets nets |
roughness |
1 (par défaut) | Totalement rugueux, comme la craie ou l’argile |
metallic |
0 | Non métallique : plastique, bois, pierre |
metallic |
1 | Métal qui teinte ses reflets de sa couleur |
Un plastique rose brillant est donc une couleur avec une rugosité de 0,3 ; le chrome est blanc avec metallic 1 et une rugosité de 0,05 ; l’or est une couleur dorée avec metallic 1. Les métaux reflètent surtout ce qui les entoure : ils rendent mieux avec un environnement à refléter.

Personne ne construit un personnage avec des cubes. Les artistes exportent leurs modèles depuis des outils comme Blender au format glTF (.gltf ou .glb), un format ouvert qui peut contenir maillages, matériaux et animations. Dans PixiJS 3D, on charge le fichier avec Assets.load, on l’enveloppe dans un Model3D et on lance l’une de ses animations avec autoPlay. Les modèles gardent la taille à laquelle ils ont été créés : mesurez-les et mettez-les à l’échelle avant de les placer. Quand un modèle constitue toute la scène, View3D.from(source) crée une vue avec caméra et lumière déjà en place.
Au-delà des bases, le moteur gère le skinning, les morph targets, les textures compressées, les matériaux PBR, Phong, flat et toon, le HDR, le tone mapping, le post-traitement, les particules et les ombres en cascade.
Deux jeux gratuits créés avec PixiJS 3D
L’équipe PixiJS a développé deux jeux avec le moteur et les a mis en ligne sur son site Good Stuff, où l’on peut y jouer gratuitement dans le navigateur.
Nightward est un jeu de survie dans un cimetière éclairé par la lune. Vous ne faites que vous déplacer : six armes tirent toutes seules pendant que la horde grossit, jusqu’à ce que le Grave Reaper surgisse de la crypte. Les sprites en pixel art sont placés dans une scène 3D sous forme de billboards éclairés qui projettent des ombres, avec bloom, tilt-shift et brouillard par-dessus. Plus étonnant : le jeu dessine ses graphismes et compose sa musique en code, il ne charge donc aucun fichier image ou audio.

Mach 2 est un runner en half-pipe. Vous tournez autour du tube, sautez et ramassez des cubes à travers cinq zones, avec un HUD 2D par-dessus la course. Il fonctionne en WebGPU ou WebGL2, au clavier ou sur mobile.
Astuces rapides pour les joueurs :
- Dans Nightward, déplacez-vous en larges cercles ; rester immobile laisse la horde se refermer, alors que vos armes ont besoin d’espace.
- Dans Mach 2, servez-vous de toute la courbe du tube pour aligner les cubes avant de sauter.
- Si un jeu saccade, fermez les autres onglets gourmands et vérifiez que l’accélération matérielle est activée dans les paramètres du navigateur.

Et ensuite, pour les développeurs de jeux web
- Commencez petit. Suivez le quick start officiel, puis copiez un exemple et changez un nombre à la fois. Chaque exemple de la galerie est fourni avec son code source.
- Essayez les tutoriels. Trois projets tournent dans un éditeur en ligne : des formes flottantes, une vitrine de modèles et un stand de tir qui construit un petit jeu étape par étape.
- Lisez un jeu complet. Le jeu de course des exemples montre comment s’articule un projet entier.

- Utilisez un agent de code IA à bon escient. L’équipe publie une skill
pixijs-3dpour des agents comme Claude Code, Cursor, Codex et Copilot, à installer avecnpx skills add https://github.com/pixijs/pixijs-skills. Elle recense les erreurs qui ne déclenchent aucune exception mais produisent une image fausse. - N’oubliez pas que c’est une bêta. Les testeurs de la bêta fermée ont envoyé plus de 30 rapports de bugs et demandes de fonctionnalités avant le lancement, et l’API peut encore évoluer avant la 1.0. Figez votre version et lisez les notes de version avant de mettre à jour.
Liens officiels utiles : l’annonce de PixiJS 3D, le tutoriel 3D 101, la galerie d’exemples et les jeux Good Stuff.
FAQ
PixiJS 3D est-il gratuit ?
Oui. PixiJS 3D est sous licence MIT, et l’équipe affirme qu’il le restera. Vous pouvez l’utiliser dans des projets gratuits comme commerciaux.
Faut-il WebGPU pour utiliser PixiJS 3D ?
Non. Il est conçu autour de WebGPU, mais le même code tourne sur WebGL2, et chaque navigateur ne télécharge que le backend qu’il utilise.
Peut-on mélanger 2D et 3D dans un même jeu PixiJS ?
Oui. Un View3D est un objet d’affichage : vous pouvez placer des scènes 3D dans un stage 2D, dessiner une interface 2D par-dessus la 3D et même dessiner des conteneurs 2D sur des surfaces 3D.
Quelle version de PixiJS faut-il ?
@pixi/3d demande pixi.js 8.23.0 ou plus récent, et doit être importé avant l’exécution de app.init.
Peut-il charger des modèles Blender ?
Oui. Exportez votre modèle en glTF (.gltf ou .glb), chargez-le avec Assets.load et affichez-le avec Model3D, animations comprises.
Où jouer à des jeux créés avec PixiJS 3D ?
Nightward et Mach 2 sont jouables gratuitement dans le navigateur sur le site officiel Good Stuff, goodstuff.pixijs.io.




