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

object-pooling — правило для Claude Code: пул объектов в Three.js

Правило object-pooling учит агента переиспользовать снаряды, частицы и NPC из пула, вместо того чтобы создавать и удалять меши каждый кадр.

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

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

Что делает object-pooling

Правило задаёт агенту паттерн пула для сцен Three.js: класс ObjectPool с factory, reset и стартовым размером, методы acquire и release, предварительный прогрев объектов на загрузке. В списке применений — пули, частицы, снаряды, спавн врагов и коллекционные предметы.

Внутри лежит markdown-файл с готовым классом и примером пула пуль. Все меши делят одну геометрию и материал, прячутся через visible = false вместо удаления со сцены и возвращаются в пул, когда длина позиции перевалит за 100. Рядом антипаттерн: новый SphereGeometry и MeshBasicMaterial на каждый спавн внутри setTimeout, без освобождения — память растёт.

Сбрасывать состояние при release правило просит не зря. Не обнулили userData.velocity — следующий снаряд полетит по старой траектории. Примеры написаны на JavaScript под Three.js, в другом движке класс придётся адаптировать.

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

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

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

  • Сделай пул пуль для сцены Three.js: заготовь 50 мешей с общей геометрией и материалом, выдавай через acquire, возвращай через release.
  • Переделай спавн частиц по правилу object-pooling: никаких новых SphereGeometry и MeshBasicMaterial в игровом цикле.
  • Добавь сброс состояния при release: обнуляй userData.velocity и прячь объект через visible = false.

Как установить object-pooling

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

.claude/rules/object-pooling.md

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

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

Вопросы об object-pooling

Как установить object-pooling в Claude Code?

Положите файл правила в проект по пути .claude/rules/object-pooling.md.

Что делает object-pooling?

Даёт агенту готовый рецепт пула: acquire и release, прогретые объекты, общая геометрия и материал, чтобы ничего не выделялось заново каждый кадр.

Чем плох спавн мешей через setTimeout?

Каждый вызов создаёт новые SphereGeometry и MeshBasicMaterial, а после удаления со сцены они остаются в памяти.

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

object-pooling.md · MIT
# Object Pooling

> Source: [100 Three.js Tips - Utsubo](https://www.utsubo.com/blog/threejs-best-practices-100-tips)

Object pooling prevents garbage collection pauses by reusing objects instead of creating/destroying them.

## When to Use

- Bullets, particles, projectiles
- Spawned enemies/NPCs
- Collectibles
- Any frequently created/destroyed objects

## Implementation

```javascript
class ObjectPool {
  constructor(factory, reset, initialSize = 20) {
    this.factory = factory;
    this.reset = reset;
    this.pool = [];

    // Pre-warm the pool
    for (let i = 0; i < initialSize; i++) {
      const obj = factory();
      obj.visible = false;
      this.pool.push(obj);
    }
  }

  acquire() {
    const obj = this.pool.pop() || this.factory();
    obj.visible = true;
    return obj;
  }

  release(obj) {
    this.reset(obj);
    obj.visible = false;
    this.pool.push(obj);
  }
}
```

## Example: Bullet Pool

```javascript
const bulletGeometry = new THREE.SphereGeometry(0.1);
const bulletMaterial = new THREE.MeshBasicMaterial({ color: 0xffff00 });

const bulletPool = new ObjectPool(
  // Factory: create new bullet
  () => {
    const bullet = new THREE.Mesh(bulletGeometry, bulletMaterial);
    scene.add(bullet);
    return bullet;
  },
  // Reset: return bullet to initial state
  (bullet) => {
    bullet.position.set(0, 0, 0);
    bullet.userData.velocity = null;
  },
  50 // Initial pool size
);

// Spawn bullet
function fireBullet(position, direction) {
  const bullet = bulletPool.acquire();
  bullet.position.copy(position);
  bullet.userData.velocity = direction.clone().multiplyScalar(10);
  activeBullets.add(bullet);
}

// Despawn bullet
function removeBullet(bullet) {
  activeBullets.delete(bullet);
  bulletPool.release(bullet);
}

// Update loop
function updateBullets(delta) {
  for (const bullet of activeBullets) {
    bullet.position.add(
      bullet.userData.velocity.clone().multiplyScalar(delta)
    );

    // Check bounds
    if (bullet.position.length() > 100) {
      removeBullet(bullet);
    }
  }
}
```

## Key Benefits

1. **No GC pauses** - Objects are reused, not collected
2. **Predictable memory** - Pool size is bounded
3. **Faster spawning** - No allocation overhead

## Best Practices

1. **Pre-warm pools** - Create objects during loading, not gameplay
2. **Share geometry/material** - All pooled objects use same resources
3. **Reset completely** - Clear all state when releasing
4. **Size appropriately** - Match pool size to max concurrent objects
5. **Use visibility** - Toggle `visible` instead of add/remove from scene

## Anti-Pattern

```javascript
// BAD: Creates garbage every frame
function spawnParticle() {
  const particle = new THREE.Mesh(
    new THREE.SphereGeometry(0.1), // New geometry!
    new THREE.MeshBasicMaterial() // New material!
  );
  scene.add(particle);

  setTimeout(() => {
    scene.remove(particle);
    // Memory leak: geometry/material not disposed
  }, 1000);
}
```

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

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

Все правила IDE по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
webgl-3d-object MengTo Скилл webgl-3d-object добавляет в агент правила генерации трёхмерных объектов на Three.js с честным PBR-освещением, тенями и анимацией вместо псевдо-3D на CSS. CX Codex +1 2 000установок groups-and-containers phaserjs Скилл groups-and-containers для Phaser 4: разбирает Group, Container и Layer, пулы объектов и вложенные трансформы, чтобы вы не гадали, чем группировать спрайты. CX Codex +1 984установок game-object-components phaserjs Скилл game-object-components для Claude Code — справочник по компонентам и миксинам игровых объектов Phaser 4 для настройки Transform, Depth и WebGL-эффектов. CX Codex +1 978установок threejs-performance CloudAI-X Скилл threejs-performance для Claude Code, Codex, Cursor и других платформ измеряет быстродействие three.js и оптимизирует рендеринг. Запускается, когда сцена тормозит или превышает лимит памяти. CX Codex +1 7 100установок threejs-game OpusGameLabs Скилл threejs-game для Claude Code: задаёт структуру проекта и обязательные модули для 3D-игры в браузере на Three.js. Разворачивает сцену и игровой цикл с нуля. CX Codex +1 1 200установок add-feature OpusGameLabs Скилл add-feature для Claude Code добавляет игровую механику в браузерные игры на Three.js или Phaser: бонусы, комбо и двойной прыжок интегрируются через EventBus, Constants и GameState. CX Codex +1 1 100установок

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

Весь набор →
asset-compression Правило asset-compression с инструкциями по сжатию 3D-ассетов для Three.js. Помогает настроить Draco, Meshopt, KTX2-текстуры и LOD для ускорения 3D-сцен в вебе. CX Codex +1 ★ 4 719звёзд репо perf-never-set-state-in-useframe Правило perf-never-set-state-in-useframe для react-three-fiber: не вызывать setState внутри useFrame, потому что это даёт перерисовку на каждом кадре. Вместо состояния React — мутация ref. CX Codex +1 ★ 4 719звёзд репо 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звёзд репо 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звёзд репо geometry-instanced-mesh Правило geometry-instanced-mesh задаёт использование THREE.InstancedMesh вместо отдельных мешей для рендеринга множества одинаковых 3D-объектов. CX Codex +1 ★ 4 719звёзд репо

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

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