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

geometry-instanced-mesh — правило для Claude Code

Правило geometry-instanced-mesh задаёт использование THREE.InstancedMesh вместо отдельных мешей для рендеринга множества одинаковых 3D-объектов.

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

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

Что делает geometry-instanced-mesh

Правило ориентирует модель на оптимизацию рендеринга в Three.js. Вместо создания тысяч отдельных экземпляров THREE.Mesh, каждый из которых требует отдельного вызова отрисовки (draw call), оно предписывает собирать одинаковые объекты в один THREE.InstancedMesh. В инструкции описаны паттерны инициализации через вспомогательный THREE.Object3D, обновление матриц трансформации, раскраска через setColorAt и обработка кликов через THREE.Raycaster с чтением instanceId.

В материале зафиксированы чёткие ограничения. Подход не подходит для сцен с разными геометриями или материалами, для сложной покадровой анимации отдельных сущностей, а также для массивов менее чем из 100 объектов из-за накладных расходов на инстансинг.

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

  • сократить количество вызовов отрисовки при рендере тысяч одинаковых мешей
  • настроить индивидуальные трансформации и цвета через матрицу инстансов
  • реализовать выбор отдельных копий кликом мыши с помощью raycaster

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

  • Оптимизируй генерацию леса из 5000 одинаковых деревьев на Three.js
  • Покажи, как менять цвет конкретного инстанса по клику через raycaster
  • Перепиши цикл создания кубов на использование THREE.InstancedMesh

Как установить geometry-instanced-mesh

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

.claude/rules/geometry-instanced-mesh.md

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

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

Вопросы о geometry-instanced-mesh

Как установить geometry-instanced-mesh в Claude Code?

Сохраните файл правила по пути .claude/rules/geometry-instanced-mesh.md в корне вашего проекта.

Что делает правило geometry-instanced-mesh?

Оно обучает ассистента заменять создание множества отдельных THREE.Mesh на единый THREE.InstancedMesh, объединяя отрисовку копий в один draw call.

Когда это правило не стоит применять?

Инстансинг не нужен, если в сцене меньше 100 объектов, а также если элементам требуются разные материалы, разные геометрии или сложная индивидуальная анимация.

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

geometry-instanced-mesh.md · MIT
# geometry-instanced-mesh

**Use InstancedMesh for many identical objects.**

## Why It Matters

Each mesh = 1 draw call. 10,000 meshes = 10,000 draw calls = terrible performance. InstancedMesh renders multiple copies in a single draw call while allowing individual transforms and colors.

## Bad Example

```javascript
// BAD - 10000 draw calls
for (let i = 0; i < 10000; i++) {
  const mesh = new THREE.Mesh(geometry, material);
  mesh.position.random().multiplyScalar(100);
  scene.add(mesh);
}
```

This creates 10,000 separate objects, each requiring its own draw call.

## Good Example

```javascript
// GOOD - Single draw call for 10000 instances
const instancedMesh = new THREE.InstancedMesh(geometry, material, 10000);

const dummy = new THREE.Object3D();
const color = new THREE.Color();

for (let i = 0; i < 10000; i++) {
  // Set position
  dummy.position.random().multiplyScalar(100);
  dummy.rotation.random();
  dummy.scale.setScalar(0.5 + Math.random() * 0.5);
  dummy.updateMatrix();
  instancedMesh.setMatrixAt(i, dummy.matrix);

  // Set color (optional)
  color.setHSL(Math.random(), 0.8, 0.5);
  instancedMesh.setColorAt(i, color);
}

instancedMesh.instanceMatrix.needsUpdate = true;
if (instancedMesh.instanceColor) {
  instancedMesh.instanceColor.needsUpdate = true;
}

scene.add(instancedMesh);
```

## Updating Instances

```javascript
// Update a single instance
function updateInstance(index, position, rotation, scale) {
  dummy.position.copy(position);
  dummy.rotation.copy(rotation);
  dummy.scale.copy(scale);
  dummy.updateMatrix();
  instancedMesh.setMatrixAt(index, dummy.matrix);
  instancedMesh.instanceMatrix.needsUpdate = true;
}

// Update in animation loop
function animate() {
  for (let i = 0; i < 100; i++) {
    instancedMesh.getMatrixAt(i, dummy.matrix);
    dummy.matrix.decompose(dummy.position, dummy.quaternion, dummy.scale);
    dummy.rotation.y += 0.01;
    dummy.updateMatrix();
    instancedMesh.setMatrixAt(i, dummy.matrix);
  }
  instancedMesh.instanceMatrix.needsUpdate = true;

  renderer.render(scene, camera);
}
```

## Raycasting

```javascript
const raycaster = new THREE.Raycaster();

function onMouseClick(event) {
  raycaster.setFromCamera(mouse, camera);
  const intersects = raycaster.intersectObject(instancedMesh);

  if (intersects.length > 0) {
    const instanceId = intersects[0].instanceId;
    console.log('Clicked instance:', instanceId);

    // Change color of clicked instance
    instancedMesh.setColorAt(instanceId, new THREE.Color(0xff0000));
    instancedMesh.instanceColor.needsUpdate = true;
  }
}
```

## Performance Comparison

| Method | Objects | Draw Calls | Performance |
|--------|---------|------------|-------------|
| Individual Meshes | 10,000 | 10,000 | ~5 FPS |
| InstancedMesh | 10,000 | 1 | ~60 FPS |

## When NOT to Use

- Different geometries needed
- Different materials needed
- Complex per-object animations
- < 100 objects (overhead not worth it)

## References

- [Three.js InstancedMesh](https://threejs.org/docs/#api/en/objects/InstancedMesh)
- [Instancing Example](https://threejs.org/examples/#webgl_instancing_performance)

© zebbern · MIT · zebbern/claude-code-guide

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

Все правила IDE по теме «Фронтенд и UI» →
threejs-perf OpusGameLabs Скилл threejs-perf переводит отрисовку повторяющихся объектов Three.js на InstancedMesh и пакетное обновление матриц. Снижает число draw calls в сценах с сотнями одинаковых мешей. CX Codex +1 753установок threejs-geometry CloudAI-X Скилл threejs-geometry учит ИИ-агента создавать стандартные и процедурные геометрии three.js, настраивать буферные атрибуты и генерировать 3D-текст. CX Codex +1 20 600установок threejs-performance CloudAI-X Скилл threejs-performance для Claude Code, Codex, Cursor и других платформ измеряет быстродействие three.js и оптимизирует рендеринг. Запускается, когда сцена тормозит или превышает лимит памяти. CX Codex +1 7 100установок three-best-practices three-agent-skills Скилл three-best-practices для Claude Code с правилами оптимизации Three.js. Срабатывает при написании, ревью и отладке кода с 3D-сценами, WebGL/WebGPU, шейдерами и TSL. CX Codex +1 1 700установок react-three-fiber-architect Claude Design Skillstack Субагент react-three-fiber-architect для проектирования 3D-сцен на React Three Fiber: разбирает архитектуру, ищет узкие места рендера и предлагает план оптимизации. CX Codex ★ 1 428звёзд репо threejs-aaa-graphics-builder majidmanzarpour Скилл threejs-aaa-graphics-builder переводит браузерную 3D-графику Three.js из прототипа в качественный продакшен: настраивает материалы, свет, шейдеры и проверяет сцену по шкале качества. CX Codex +1 4 300установок

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

Весь набор →
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звёзд репо drei-use-gltf Правило drei-use-gltf для Claude Code задаёт загрузку GLTF-моделей через useGLTF с кэшированием и предварительной загрузкой. Используется в сценах на React Three Fiber. CX Codex +1 ★ 4 719звёзд репо perf-zustand-selectors Правило perf-zustand-selectors для ИИ-агента: подписка в компоненте идёт на отдельный срез Zustand-стора, поэтому перерисовка случается только при изменении нужных данных. 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звёзд репо core-web-vitals Правило core-web-vitals для Claude Code: грузит модели и текстуры в 3D-сценах на Three.js так, чтобы LCP, FID и CLS не проседали. Не даёт тяжёлому 3D тормозить первую отрисовку. CX Codex +1 ★ 4 719звёзд репо postprocessing-optimization Правило postprocessing-optimization для Three.js и React Three Fiber. Помогает оптимизировать постобработку и объединять шейдерные проходы без просадок FPS. CX Codex +1 ★ 4 719звёзд репо

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

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