drei-use-gltf — правило для Claude Code: что делает и установка
Правило drei-use-gltf для Claude Code задаёт загрузку GLTF-моделей через useGLTF с кэшированием и предварительной загрузкой. Используется в сценах на React Three Fiber.
MIT ★ 4 719 обновлён 2026-10-24
.claude/rules/drei-use-gltf.mdЧто делает drei-use-gltf
Правило рекомендует брать useGLTF из @react-three/drei для загрузки GLTF-моделей. Хук возвращает scene, nodes и materials, поддерживает интеграцию с Suspense, кэширует повторные загрузки и умеет работать с Draco-декомпрессией.
Для более ранней загрузки модель вызывают через useGLTF.preload('/model.glb'); можно передать массив путей. Несколько экземпляров стоит создавать через scene.clone(), чтобы они не делили состояние. В примерах также показаны типизация GLTF в TypeScript и dispose={null} для общих моделей.
Без @react-three/drei это правило неприменимо. Для Draco-модели нужен путь к декодеру, например '/draco/'; R3F по умолчанию сам освобождает ресурсы.
Какие задачи решает
- загрузить GLTF-модель через
useGLTF - запустить предварительную загрузку моделей
- показать сцену через
Suspenseво время загрузки - получить узлы и материалы модели
- создать несколько независимых экземпляров сцены
Примеры запросов агенту
- Загрузи
model.glbчерезuseGLTFи выведи его сцену в компоненте. - Добавь предварительную загрузку для
model1.glb,model2.glbиmodel3.glb. - Покажи несколько экземпляров
tree.glbчерезscene.clone()с разными позициями.
Как установить drei-use-gltf
Вручную: положить файлы
.claude/rules/drei-use-gltf.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/drei-use-gltf.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/drei-use-gltf.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/drei-use-gltf.mdВручную: положить файлы
.clinerules/drei-use-gltf.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о drei-use-gltf
Как установить drei-use-gltf в Claude Code?
Размести файл правила по пути .claude/rules/drei-use-gltf.md.
Что делает drei-use-gltf?
Правило направляет загрузку GLTF через useGLTF из @react-three/drei. Оно описывает кэширование, Suspense, предварительную загрузку, Draco, доступ к узлам и материалам, клонирование сцен и обработку освобождения ресурсов.
Как подключить Draco-декомпрессию в drei-use-gltf?
Передай путь к декодеру вторым аргументом: useGLTF('/model.glb', '/draco/'). Для предварительной загрузки используй тот же путь в useGLTF.preload('/model.glb', '/draco/').
Исходный текст
drei-use-gltf.md · MIT
# drei-use-gltf
**Use useGLTF for model loading with preloading.**
## Why It Matters
`useGLTF` from Drei provides:
- Suspense integration (automatic loading states)
- Caching (same model loaded once)
- Preloading capability
- Draco decompression support
## Basic Example
```jsx
import { useGLTF } from '@react-three/drei';
function Model() {
const { scene, nodes, materials } = useGLTF('/model.glb');
return <primitive object={scene} />;
}
```
## Preloading (Critical for UX)
```jsx
import { useGLTF } from '@react-three/drei';
function Model() {
const { scene } = useGLTF('/model.glb');
return <primitive object={scene} />;
}
// Preload at module level - starts loading immediately
useGLTF.preload('/model.glb');
// Or preload multiple models
useGLTF.preload(['/model1.glb', '/model2.glb', '/model3.glb']);
```
## With Draco Compression
```jsx
function DracoModel() {
// Second argument is the Draco decoder path
const { scene } = useGLTF('/model.glb', '/draco/');
return <primitive object={scene} />;
}
useGLTF.preload('/model.glb', '/draco/');
```
## Accessing Nodes and Materials
```jsx
function Character() {
const { nodes, materials } = useGLTF('/character.glb');
return (
<group>
<mesh
geometry={nodes.Body.geometry}
material={materials.Skin}
/>
<mesh
geometry={nodes.Clothes.geometry}
material={materials.Fabric}
/>
</group>
);
}
```
## Clone for Multiple Instances
```jsx
function Tree({ position }) {
const { scene } = useGLTF('/tree.glb');
// Clone to avoid sharing state between instances
return <primitive object={scene.clone()} position={position} />;
}
function Forest() {
return (
<>
<Tree position={[0, 0, 0]} />
<Tree position={[5, 0, 0]} />
<Tree position={[10, 0, 0]} />
</>
);
}
```
## With Suspense
```jsx
import { Suspense } from 'react';
import { useGLTF } from '@react-three/drei';
function Model() {
const { scene } = useGLTF('/model.glb');
return <primitive object={scene} />;
}
function Scene() {
return (
<Suspense fallback={<LoadingBox />}>
<Model />
</Suspense>
);
}
function LoadingBox() {
return (
<mesh>
<boxGeometry />
<meshBasicMaterial wireframe color="white" />
</mesh>
);
}
```
## TypeScript Types
```tsx
import { useGLTF } from '@react-three/drei';
import { GLTF } from 'three-stdlib';
type GLTFResult = GLTF & {
nodes: {
Body: THREE.Mesh;
Head: THREE.Mesh;
};
materials: {
Skin: THREE.MeshStandardMaterial;
};
};
function Model() {
const { nodes, materials } = useGLTF('/model.glb') as GLTFResult;
// Now nodes.Body and materials.Skin are typed
}
```
## Dispose Handling
R3F auto-disposes by default. To prevent disposal (for shared models):
```jsx
function SharedModel({ model }) {
return <primitive object={model} dispose={null} />;
}
```
## References
- [Drei useGLTF](https://github.com/pmndrs/drei#usegltf)
- [gltfjsx](https://github.com/pmndrs/gltfjsx) - Generate JSX from GLTF
© zebbern · MIT · zebbern/claude-code-guide