Three.js (referencia oficial para LLM)
Este skill incluye el paquete oficial de documentación de Three.js para LLM para que el agente pueda generar código moderno y correcto de three.js sin inventar APIs obsoletas de CDN o r128.
Adaptación a la pila (constructor de esta aplicación)
Te encuentras en un espacio de trabajo TanStack Start + React, no en una página HTML simple:
| Patrón de documentación oficial | Haz esto aquí en su lugar |
|---|---|
<script type="importmap"> + CDN three | npm install three (+ @types/three si es necesario); importar desde "three" / "three/addons/…" |
| Inicialización básica con canvas HTML | Prefiere @react-three/fiber + drei para juegos/integración con UI (building-games + 3d-libs.md) |
Demostración independiente con WebGLRenderer | Válido para un módulo de canvas autocontenido; aún así instala three mediante npm para que la compilación en Vercel lo tenga |
| Siempre la versión "más reciente" de CDN | Fija la versión en package.json para que coincidan desarrollo y despliegue |
Three no está preinstalado — agrégalo con npm y déjalo en package.json.
Cuándo cargar qué
- Juego / producto 3D interactivo → comienza con
building-games(bucle, controles, orientación, cámara, primera ejecución, señal de giro). - Conexión R3F / drei / rapier →
building-games/references/3d-libs.md. - API profunda de three, TSL, WebGPU, materiales, cargadores, postprocesado → carga
references/llms-full.txt(el volcado oficial completo de este skill).
No cargues llms-full.txt para juegos simples de canvas 2D (Pong, tetris, etc.).
Referencia completa
Leer bajo demanda:
references/llms-full.txt
Fuente: https://threejs.org/docs/llms-full.txt (copia fija para uso en sandbox sin conexión).
Los contenidos incluyen: importaciones modernas, WebGLRenderer vs WebGPURenderer, referencia completa de TSL, NodeMaterial, cargadores, postprocesado, cómputo y tablas de API.
Valores por defecto rápidos para este producto
- Prefiere WebGLRenderer (o el valor por defecto de R3F) a menos que el usuario necesite TSL/WebGPU compute.
- Limita la relación de píxeles (
renderer.setPixelRatio(Math.min(devicePixelRatio, 2))o R3Fdpr={[1,2]}). - Elimina geometrías/materiales/texturas al cerrar (three no recolecta recursos GPU automáticamente).
- Para juegos: sigue obedeciendo las autopruebas de control y orientación de
building-games.
Verificación final
- Three (y la pila R3F si se usa) está en
package.jsony las importaciones resuelven correctamente. - No hay patrones de etiquetas script con r128 ni cdnjs.
- Si se usa TSL/WebGPU: los materiales e importaciones coinciden con
llms-full(node materials,await renderer.init()).