Three.js(公式 LLM リファレンス)
このスキルは、公式の Three.js LLM ドキュメントパックを提供し、エージェントが正しい最新の three.js を生成できるようにします。古い CDN や r128 API をでっち上げることはありません。
スタック適応(このアプリビルダー向け)
このワークスペースは TanStack Start + React 環境であり、ベアな HTML ページではありません:
| 公式ドキュメントのパターン | ここで行うべきこと |
|---|---|
<script type="importmap"> + CDN three | npm install three(必要に応じて @types/three も); "three" / "three/addons/…" からインポート |
| 生の HTML キャンバスブートストラップ | ゲーム/UI 統合には @react-three/fiber + drei を推奨(building-games + 3d-libs.md) |
スタンドアロン WebGLRenderer デモ | 自己完結型キャンバスモジュールとしては問題なし。それでも three は npm 経由でインストールし、Vercel ビルドで利用できるようにする |
| 常に「最新」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、テトリスなど)には llms-full.txt を読み込まないでください。
完全リファレンス
必要に応じて読み込んでください。
references/llms-full.txt
出典: https://threejs.org/docs/llms-full.txt(オフラインサンドボックス用に固定コピー)。
内容: 最新のインポート、WebGLRenderer と WebGPURenderer の比較、TSL 完全リファレンス、NodeMaterial、ローダー、ポストプロセッシング、コンピュート、API テーブル。
この製品向けのクイックデフォルト設定
- WebGLRenderer(または R3F デフォルト)を優先。ただし、ユーザーが TSL/WebGPU コンピュートを必要とする場合は除く。
- ピクセル比を制限する(
renderer.setPixelRatio(Math.min(devicePixelRatio, 2))または R3F のdpr={[1,2]})。 - ティアダウン時にジオメトリ/マテリアル/テクスチャを破棄する(three は GPU リソースを GC しない)。
- ゲームの場合: 引き続き
building-gamesのコントロールと向きのセルフテストに従うこと。
完了チェック
- three(および使用する場合は R3F スタック)が
package.jsonにあり、インポートが解決されること。 - r128 / cdnjs スクリプトタグのパターンがないこと。
- TSL/WebGPU を使用する場合: マテリアルとインポートが
llms-fullと一致すること(ノードマテリアル、await renderer.init())。