Three.js (공식 LLM 레퍼런스)은(는) 무엇을 하나요?
이 스킬은 공식 Three.js LLM 문서 패키지를 제공하므로 에이전트가 구식 CDN/r128 API를 발명하지 않고 정확한 최신 three.js 코드를 생성할 수 있습니다.
스택 적응 (이 앱 빌더)
현재 TanStack Start + React 워크스페이스에 있으며, bare HTML 페이지가 아닙니다.
| 공식 문서 패턴 | 여기서는 이렇게 하세요 |
|---|---|
<script type="importmap"> + CDN three | npm install three (필요시 @types/three) ; "three" / "three/addons/…" 로 import |
| Raw HTML 캔버스 부트스트랩 | 게임/UI 통합을 위해 @react-three/fiber + drei 권장 (building-games + 3d-libs.md) |
독립형 WebGLRenderer 데모 | 자체 포함 캔버스 모듈에는 괜찮음; 그래도 Vercel 빌드에서 사용할 수 있도록 npm으로 three 설치 |
| 항상 "최신" CDN 버전 | package.json에서 버전 고정하여 개발과 배포 버전 일치 |
three는 사전 설치되어 있지 않습니다 — npm으로 추가하고 package.json에 남겨두세요.
언제 무엇을 로드할지
- 게임 / 인터랙티브 3D 제품 →
building-games로 시작 (루프, 컨트롤, 방향, 카메라, 첫 실행, 조향 신호). - R3F / drei / rapier 연결 →
building-games/references/3d-libs.md. - 심층 three API, TSL, WebGPU, 머티리얼, 로더, 후처리 →
references/llms-full.txt로드 (이 스킬의 전체 공식 덤프).
간단한 2D 캔버스 게임(Pong, tetris 등)에서는 llms-full.txt를 로드하지 마세요.
전체 레퍼런스
필요 시 읽기:
references/llms-full.txt
출처: https://threejs.org/docs/llms-full.txt (오프라인 샌드박스 사용을 위한 고정 복사본).
내용 포함: 최신 import, WebGLRenderer vs WebGPURenderer, TSL 전체 레퍼런스, NodeMaterial, 로더, 후처리, 컴퓨트, API 테이블.
이 제품을 위한 빠른 기본값
- WebGLRenderer (또는 R3F 기본값) 선호 (사용자가 TSL/WebGPU 컴퓨트를 필요로 하지 않는 한).
- 픽셀 비율 제한 (
renderer.setPixelRatio(Math.min(devicePixelRatio, 2))또는 R3Fdpr={[1,2]}). - 종료 시 지오메트리/머티리얼/텍스처 dispose (three는 GPU 리소스를 GC하지 않음).
- 게임의 경우: 여전히
building-games컨트롤 및 방향 자체 테스트를 따르세요.
완료 확인
- three (및 사용된 R3F 스택)가
package.json에 있고 import가 해결됩니다. - r128 / cdnjs script-tag 패턴이 없습니다.
- TSL/WebGPU 사용 시: 머티리얼과 import가
llms-full과 일치합니다 (node materials,await renderer.init()).