Three.js (référence officielle LLM)
Cette compétence fournit le pack de documentation officiel Three.js conçu pour les LLM, afin que l'agent puisse générer du code three.js moderne et correct sans inventer des API obsolètes de CDN ou de la version r128.
Adaptation de la pile (constructeur d'application)
Vous êtes dans un espace de travail TanStack Start + React, pas une page HTML nue :
| Schéma officiel | À faire ici à la place |
|---|---|
<script type="importmap"> + CDN three | npm install three (+ @types/three si nécessaire) ; importer depuis "three" / "three/addons/…" |
| Bootstrap canvas HTML brut | Préférer @react-three/fiber + drei pour les jeux/l'intégration UI (building-games + 3d-libs.md) |
Démo autonome de WebGLRenderer | Bon pour un module canvas indépendant ; installer quand même three via npm pour que le build Vercel l'ait |
| Toujours la version « latest » via CDN | Épingler via package.json pour que le développement et le déploiement correspondent |
three n'est pas préinstallé — ajoutez-le avec npm et laissez-le dans package.json.
Quand charger quoi
- Jeu / produit 3D interactif → commencer par
building-games(boucle, contrôles, orientation, caméra, premier lancement, panneau de direction). - Câblage R3F / drei / rapier →
building-games/references/3d-libs.md. - API three avancée, TSL, WebGPU, matériaux, chargeurs, post-processing → charger
references/llms-full.txt(le dump officiel complet de cette compétence).
Ne pas charger llms-full.txt pour des jeux 2D canvas simples (Pong, tetris, etc.).
Référence complète
Lire à la demande :
references/llms-full.txt
Source : https://threejs.org/docs/llms-full.txt (copie épinglée pour une utilisation hors ligne dans le sandbox).
Le contenu comprend : imports modernes, WebGLRenderer vs WebGPURenderer, référence complète TSL, NodeMaterial, chargeurs, post-processing, calcul, et tables d'API.
Valeurs par défaut rapides pour ce produit
- Préférer WebGLRenderer (ou le défaut R3F) sauf si l'utilisateur a besoin de calcul TSL/WebGPU.
- Limiter le ratio de pixels (
renderer.setPixelRatio(Math.min(devicePixelRatio, 2))oudpr={[1,2]}pour R3F). - Nettoyer les géométries/matériaux/textures à la destruction (three ne libère pas automatiquement les ressources GPU).
- Pour les jeux : toujours respecter les auto-tests de contrôle et d'orientation de
building-games.
Vérification finale
- three (et la pile R3F si utilisée) est dans
package.jsonet les imports résolvent. - Pas de motifs avec r128 / script-tag cdnjs.
- Si TSL/WebGPU est utilisé : les matériaux et imports correspondent à
llms-full(node materials,await renderer.init()).