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

gltf-loading-optimization — правило для Claude Code

Правило gltf-loading-optimization для Claude Code содержит сниппеты и команды для загрузки glTF в Three.js, настройки декодеров, прогресса, ленивой подгрузки и сжатия моделей.

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

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

Что делает gltf-loading-optimization

Правило даёт агенту готовые сниппеты для загрузки glTF в Three.js: GLTFLoader вместе с DRACOLoader, KTX2Loader и MeshoptDecoder, обработчики прогресса и ошибок, LoadingManager на несколько ассетов и схема ленивой подгрузки, где сначала идёт главная модель, а декор позже.

Для сжатия внутри есть команды gltf-transform: draco и meshopt по геометрии, webp и ktx по текстурам, плюс общий конвейер gltf-transform optimize input.glb output.glb --compress draco --texture-compress webp --texture-size 1024. Утилита ставится отдельно: npm install -g @gltf-transform/cli.

Декодеры нужно откуда-то отдать: правило прописывает setDecoderPath('/draco/') и setTranscoderPath('/basis/'), а в запасе держит ссылки на Google CDN и jsDelivr. Без этих файлов модель не загрузится. Для анимированных моделей берите Meshopt, потому что Draco анимацию и морф-таргеты не поддерживает.

Какие задачи решает

  • Подключить Draco, KTX2 и Meshopt к GLTFLoader
  • Сжать геометрию модели перед выкладкой
  • Перевести текстуры в KTX2 или WebP
  • Показать прогресс загрузки сцены
  • Отделить критичные ассеты от фоновых

Примеры запросов агенту

  • Собери загрузчик glTF с Draco и KTX2 по правилу gltf-loading-optimization
  • Прогони model.glb через gltf-transform optimize и скажи, что изменилось
  • Добавь экран загрузки на LoadingManager и прогресс в процентах

Как установить gltf-loading-optimization

Вручную: положить файлы

.claude/rules/gltf-loading-optimization.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о gltf-loading-optimization

Как установить gltf-loading-optimization в Claude Code?

Скопируйте файл правила в проект по пути .claude/rules/gltf-loading-optimization.md. Этого достаточно.

Что делает gltf-loading-optimization?

Описывает загрузку glTF в Three.js: подключение декодеров Draco, KTX2 и Meshopt, прогресс, ленивую подгрузку и сжатие моделей через gltf-transform.

Что выбрать для анимированной модели: Draco или Meshopt?

Meshopt. Draco сжимает геометрию сильнее, но анимацию и морф-таргеты не поддерживает, а декодирует медленнее.

Исходный текст

gltf-loading-optimization.md · MIT
# GLTF Loading & Optimization

Complete setup for loading and optimizing 3D models.

## Full Loader Setup

```javascript
import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
import { DRACOLoader } from 'three/addons/loaders/DRACOLoader.js';
import { MeshoptDecoder } from 'three/addons/libs/meshopt_decoder.module.js';
import { KTX2Loader } from 'three/addons/loaders/KTX2Loader.js';

// DRACO decoder
const dracoLoader = new DRACOLoader();
dracoLoader.setDecoderPath('/draco/');

// KTX2 transcoder
const ktx2Loader = new KTX2Loader();
ktx2Loader.setTranscoderPath('/basis/');
ktx2Loader.detectSupport(renderer);

// GLTF loader with all decoders
const gltfLoader = new GLTFLoader();
gltfLoader.setDRACOLoader(dracoLoader);
gltfLoader.setMeshoptDecoder(MeshoptDecoder);
gltfLoader.setKTX2Loader(ktx2Loader);

// Load model
gltfLoader.load('model.glb', (gltf) => {
  scene.add(gltf.scene);

  // Setup animations
  const mixer = new THREE.AnimationMixer(gltf.scene);
  gltf.animations.forEach((clip) => {
    mixer.clipAction(clip).play();
  });
}, onProgress, onError);
```

## Progress Tracking

```javascript
function onProgress(xhr) {
  if (xhr.lengthComputable) {
    const percent = (xhr.loaded / xhr.total) * 100;
    console.log(`Loading: ${percent.toFixed(0)}%`);
  }
}

function onError(error) {
  console.error('Error loading model:', error);
}
```

## glTF-Transform CLI

### Installation

```bash
npm install -g @gltf-transform/cli
```

### Draco Compression

```bash
gltf-transform draco input.glb output.glb --method edgebreaker
```

### Meshopt Compression

```bash
gltf-transform meshopt input.glb output.glb --level medium
```

### Texture Compression

```bash
# WebP (25-35% reduction)
gltf-transform webp input.glb output.glb --quality 75

# KTX2/Basis (75-85% reduction)
gltf-transform ktx input.glb output.glb --slots baseColor
```

### Full Optimization Pipeline

```bash
gltf-transform optimize input.glb output.glb \
  --compress draco \
  --texture-compress webp \
  --texture-size 1024
```

## Compression Results

| Method | Typical Reduction |
|--------|-------------------|
| Draco | 70-90% geometry |
| Meshopt | 60-80% geometry + morph + animation |
| KTX2/Basis | 75-85% textures |
| WebP | 25-35% textures |

## Draco vs Meshopt

| Feature | Draco | Meshopt |
|---------|-------|---------|
| Compression | Higher | Lower |
| Decode Speed | Slower | Faster |
| Animation | No | Yes |
| Morph Targets | No | Yes |
| Recommendation | Static models | Animated models |

## Best Practices

1. **Format**: Prefer GLB over GLTF (binary, single file)

2. **Textures**: Keep 512x512 or 1024x1024 for mobile

3. **Power of Two**: Always use power-of-2 dimensions

4. **Compression**: DRACO for geometry, KTX2 for textures

5. **Host Decoders**: Host decoders locally or use reliable CDN

6. **Progress**: Always show loading progress

## CDN Decoder Paths

```javascript
// Google CDN
dracoLoader.setDecoderPath('https://www.gstatic.com/draco/v1/decoders/');

// jsDelivr
dracoLoader.setDecoderPath('https://cdn.jsdelivr.net/npm/[email protected]/examples/jsm/libs/draco/');
```

## Post-Load Processing

```javascript
gltfLoader.load('model.glb', (gltf) => {
  const model = gltf.scene;

  // Enable shadows
  model.traverse((child) => {
    if (child.isMesh) {
      child.castShadow = true;
      child.receiveShadow = true;
    }
  });

  // Fix materials (if needed)
  model.traverse((child) => {
    if (child.material) {
      child.material.envMapIntensity = 1;
    }
  });

  // Center model
  const box = new THREE.Box3().setFromObject(model);
  const center = box.getCenter(new THREE.Vector3());
  model.position.sub(center);

  scene.add(model);
});
```

## Loading Manager

```javascript
const manager = new THREE.LoadingManager();

manager.onStart = (url, loaded, total) => {
  console.log(`Loading: ${url}`);
};

manager.onProgress = (url, loaded, total) => {
  console.log(`Progress: ${loaded}/${total}`);
};

manager.onLoad = () => {
  console.log('All assets loaded');
  hideLoadingScreen();
};

manager.onError = (url) => {
  console.error(`Error loading: ${url}`);
};

const gltfLoader = new GLTFLoader(manager);
const textureLoader = new THREE.TextureLoader(manager);
```

## Lazy Loading

```javascript
// Load critical assets first
await loadCriticalAssets();
showScene();

// Load non-critical in background
loadBackgroundAssets();

async function loadCriticalAssets() {
  const hero = await gltfLoader.loadAsync('hero.glb');
  scene.add(hero.scene);
}

function loadBackgroundAssets() {
  gltfLoader.load('decorations.glb', (gltf) => {
    scene.add(gltf.scene);
  });
}
```

## References

- [glTF-Transform](https://gltf-transform.dev/)
- [Three.js GLTFLoader](https://threejs.org/docs/#examples/en/loaders/GLTFLoader)
- [Draco Compression](https://google.github.io/draco/)

© 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-asset-pipeline CloudAI-X Скилл threejs-asset-pipeline для сжатия и проверки glTF-моделей перед загрузкой в three.js: команды gltf-transform, Draco, meshopt, KTX2 и gltfjsx. CX Codex +1 6 500установок blender-web-pipeline freshtechbro Скилл blender-web-pipeline настраивает экспорт 3D-моделей из Blender в веб-формат glTF 2.0. Он помогает автоматизировать сжатие геометрии, запекание текстур и пакетную обработку сцен. CX Codex +1 4 100установок fal-regenerate-3d fal-ai-community Скилл fal-regenerate-3d для Claude Code и Codex автоматизирует сборку 3D-экрана выбора персонажей на Three.js с моделями через fal.ai. Разворачивает статическую страницу с GLB-моделями, PBR-полами и видеофонами. CX Codex +1 442установок threejs-loaders CloudAI-X Скилл threejs-loaders обучает ИИ загружать 3D-модели glTF, текстуры и HDR-карты в three.js r186. Пригодится при настройке ассетов, цветовых пространств и шкалы прогресса для WebGL или WebGPU. CX Codex +1 18 400установок threejs MengTo Помогает агенту собирать и отлаживать интерактивные 3D-сцены на Three.js: сцена, камера, свет, загрузка glTF, контролы и производительность. CX Codex +1 2 500установок

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

Весь набор →
debug-devtools Правило debug-devtools для Claude Code и Codex добавляет в Three.js-проект средства диагностики производительности, сцены и потери WebGL-контекста. Находит узкие места и проверяет параметры вживую. CX Codex +1 ★ 4 719звёзд репо tsl-post-processing Правило tsl-post-processing для Claude Code описывает постобработку Three.js на TSL: эффекты подключаются к postProcessing.outputNode без цепочки проходов EffectComposer. Агент обращается к нему при написании кода сцены. CX Codex +1 ★ 4 719звёзд репо tsl-compute-shaders Правило tsl-compute-shaders подсказывает агенту, как писать вычислительные шейдеры на Three.js TSL для WebGPU и настраивать GPGPU-симуляции вроде частиц с расчётом физики. CX Codex +1 ★ 4 719звёзд репо animation-system Правило animation-system объясняет систему анимации Three.js: от запуска и смешивания клипов до морфинга и управления костями. Пригодится при работе с анимированными 3D-моделями. CX Codex +1 ★ 4 719звёзд репо physics-integration Правило physics-integration задаёт правила связки Three.js с физическими движками Rapier и Cannon-es: настройка Vite, коллайдеры и синхронизация позиций. CX Codex +1 ★ 4 719звёзд репо raycasting-optimization Правило raycasting-optimization для Claude Code описывает, как ускорить поиск пересечений и выбор объектов в Three.js. Сокращает проверки Raycaster в интерактивных сценах и на сложных мешах. CX Codex +1 ★ 4 719звёзд репо mobile-optimization Правило mobile-optimization с готовыми паттернами для ускорения Three.js-сцен на смартфонах и планшетах. Снижает нагрузку на GPU, уменьшает потребление памяти и помогает держать стабильный FPS. CX Codex +1 ★ 4 719звёзд репо webxr-setup Правило webxr-setup для Claude Code задаёт настройку VR- и AR-сцен на Three.js через WebXR. Помогает агенту настроить рендерер, контроллеры и отслеживание рук. CX Codex +1 ★ 4 719звёзд репо

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

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