К основному содержанию
правило CX Codex

drei-use-gltf — правило для Claude Code: что делает и установка

Правило drei-use-gltf для Claude Code задаёт загрузку GLTF-моделей через useGLTF с кэшированием и предварительной загрузкой. Используется в сценах на React Three Fiber.

MIT ★ 4 719 обновлён 2026-10-24

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/drei-use-gltf.md
Открыть на GitHub

Что делает 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 и 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

Похожие правила IDE

Все правила IDE по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
threejs-gltf-loading gamedev-skills Скилл threejs-gltf-loading для Claude Code загружает модельные файлы .gltf и .glb в three.js версии r187 и запускает для них анимацию. Агент подключает этот скилл при импорте трёхмерных персонажей или отладке невидимых объектов. CX Codex +1 11 200установок threejs-react-three-fiber CloudAI-X Скилл threejs-react-three-fiber для Claude Code помогает собирать сцены three.js в React-компонентах. Он охватывает React Three Fiber, drei, цикл кадров и обработку событий указателя. CX Codex +1 6 800установок r3f-interaction EnzeD Скилл r3f-interaction настраивает события указателя, выбор объектов, перетаскивание и управление камерой в React Three Fiber. Помогает связать ввод мыши и клавиатуры без конфликтов между контроллерами сцены. CX Codex +1 3 600установок threejs-r3f cesartevisual Скилл threejs-r3f для Claude Code помогает создавать и исправлять сцены React Three Fiber. Подключается к задачам с Drei, загрузкой через Suspense, событиями и жизненным циклом React. CX Codex +1 820установок react-three-fiber vercel-labs Помогает агенту описывать 3D-сцены для json-render JSON-спекой и рендерить их через React Three Fiber: меши, свет, модели GLTF, окружение. CX Codex +1 2 400установок r3f-loaders EnzeD Скилл r3f-loaders помогает загружать и переиспользовать 3D-модели в React Three Fiber. Настраивает хуки, предзагрузку, клонирование объектов и показ заглушек. CX Codex +1 2 100установок

Из того же набора86

Весь набор →
frame-delta-time Правило frame-delta-time требует умножать движение на delta в useFrame, чтобы скорость анимации не зависела от частоты кадров. CX Codex +1 ★ 4 719звёзд репо draw-call-optimization Правило draw-call-optimization для Claude Code описывает оптимизацию сцены Three.js: снизить число вызовов отрисовки до 100 на кадр инстансингом, батчингом и слиянием геометрий. CX Codex +1 ★ 4 719звёзд репо object-pooling Правило object-pooling учит агента переиспользовать снаряды, частицы и NPC из пула, вместо того чтобы создавать и удалять меши каждый кадр. CX Codex +1 ★ 4 719звёзд репо shader-mobile Правило shader-mobile для Claude Code содержит приёмы оптимизации GLSL и Three.js шейдеров под мобильные GPU, помогающие избежать просадок FPS на смартфонах. CX Codex +1 ★ 4 719звёзд репо perf-zustand-selectors Правило perf-zustand-selectors для ИИ-агента: подписка в компоненте идёт на отдельный срез Zustand-стора, поэтому перерисовка случается только при изменении нужных данных. CX Codex +1 ★ 4 719звёзд репо geometry-instanced-mesh Правило geometry-instanced-mesh задаёт использование THREE.InstancedMesh вместо отдельных мешей для рендеринга множества одинаковых 3D-объектов. CX Codex +1 ★ 4 719звёзд репо webgpu-renderer Правило webgpu-renderer для Claude Code описывает подключение WebGPU-рендерера Three.js и запасной путь через WebGL 2. Показывает настройку 3D-сцен с вычислениями на GPU. CX Codex +1 ★ 4 719звёзд репо tsl-material-slots tsl-material-slots — правило для Claude Code со справочником слотов TSL в Three.js. Помогает настраивать шейдерную логику через узлы без ошибок в типах и именах свойств. CX Codex +1 ★ 4 719звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой