Aller au contenu

PixiJS 3D expliqué : le guide débutant des jeux 3D dans le navigateur, et 2 jeux gratuits à essayer

abe ·

PixiJS 3D ajoute un vrai moteur 3D à PixiJS, gratuit sous licence MIT. Voici de quoi est faite une scène 3D, comment créer la vôtre et deux jeux gratuits qui l'utilisent.

Couverture VENO : une île 3D rendue avec PixiJS 3D et le titre PixiJS 3D, la 3D sur le web

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

Une petite île 3D avec des sapins, une cabane rouge et un étang, rendue en temps réel par PixiJS 3D dans le navigateur d'exemples officiel, image : PixiJS

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

Un immense anneau composé de nombreux petits objets colorés dessinés avec BatchedMesh3D dans un exemple PixiJS 3D, image : PixiJS

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.

  1. 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, 0 est l’origine, et une unité vaut un mètre, d’où des nombres petits.
  2. 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.
  3. 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.
  4. Les transformations. Chaque objet a une position, une rotation et une échelle, chacune avec désormais un z. Les rotations sont en radians (Math.PI fait un demi-tour), ou utilisez angle pour les degrés. Un Container3D regroupe des objets : tourner le parent fait tourner les enfants, c’est ainsi qu’on construit une planète et sa lune.
  5. 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. OrbitCamera permet au joueur de faire glisser pour tourner autour d’une cible.
  6. Lumière et ombre. Sans lumière, un Material3D s’affiche en noir. Une DirectionalLight agit comme le soleil, une PointLight comme une ampoule et une SpotLight comme une lampe torche. Activez castShadow sur une lumière directionnelle ou un spot et les maillages projettent et reçoivent des ombres ; les lumières ponctuelles n’en projettent pas.

Les neuf formes 3D intégrées à PixiJS 3D, dont une sphère, un tore, un cône, un cube et un nœud, chacune avec un matériau argile, image : PixiJS

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.

Une grille de sphères allant du lisse au rugueux et du plastique au métal, reflétant un coucher de soleil dans PixiJS 3D, image : PixiJS

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.

Partie de Nightward avec un héros en pixel art face à une horde grandissante dans un cimetière 3D sous la lune, image : PixiJS

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 :

  1. Dans Nightward, déplacez-vous en larges cercles ; rester immobile laisse la horde se refermer, alors que vos armes ont besoin d’espace.
  2. Dans Mach 2, servez-vous de toute la courbe du tube pour aligner les cubes avant de sauter.
  3. 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.

Mach 2, un runner en half-pipe aux couleurs roses créé avec PixiJS 3D, lancé dans un navigateur de bureau, image : PixiJS

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.

L'exemple officiel de course de PixiJS 3D avec une voiture jaune sur la piste, des sapins et une arche orange, image : PixiJS

  • Utilisez un agent de code IA à bon escient. L’équipe publie une skill pixijs-3d pour des agents comme Claude Code, Cursor, Codex et Copilot, à installer avec npx 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.

Articles associés

Chargement du jeu…

VENOGAME / PLAYBOOK

Mon arène

Sur cet appareil. Aucun compte requis.

Touchez un cœur pour créer votre collection.