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

animation-system — правило для Claude Code: анимация Three.js

Правило animation-system объясняет систему анимации Three.js: от запуска и смешивания клипов до морфинга и управления костями. Пригодится при работе с анимированными 3D-моделями.

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

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

Что делает animation-system

В руководстве разобраны AnimationMixer, AnimationClip, KeyframeTrack и AnimationAction: как запустить клип, обновлять микшер с учётом времени кадра и плавно переключаться между анимациями. Также описаны режимы повтора, скорость воспроизведения и события завершения или цикла.

Отдельные примеры показывают ручное управление морф-целями, анимацию через ключевые кадры и изменение костей у SkinnedMesh. Можно собрать собственный клип для позиции, поворота или цвета. Для корректного обновления микшеру нужно передавать delta time; при удалении модели следует останавливать действия и очищать ссылки микшера.

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

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

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

  • Объясни, как запустить клип walk через AnimationMixer и обновлять его в цикле рендера.
  • Покажи, как плавно переключить модель с ходьбы на бег.
  • Составь пример анимации улыбки через morphTargetInfluences.

Как установить animation-system

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

.claude/rules/animation-system.md

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

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

Вопросы об animation-system

Как установить animation-system в Claude Code?

Используйте путь .claude/rules/animation-system.md.

Что делает правило animation-system?

Оно описывает работу с анимациями Three.js: воспроизведение и смешивание клипов, морф-цели, скелетную анимацию и создание собственных треков.

Как обновлять AnimationMixer?

Передавайте в mixer.update() delta time из часов в цикле рендера. Для одной иерархии анимируемых объектов руководство советует использовать один микшер.

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

animation-system.md · MIT
# Animation System

Complete guide to Three.js animation system including AnimationMixer, blending, morph targets, and skeletal animation.

## System Components

```
AnimationClip          --- Contains KeyframeTracks
    |
    +-- KeyframeTrack  --- Data for one animated property
    |   +-- times[]    --- Keyframe times
    |   +-- values[]   --- Values at each keyframe
    |
AnimationMixer         --- Connects clips with objects
    |
    +-- AnimationAction --- Controls playback
        +-- play()
        +-- pause()
        +-- stop()
        +-- reset()
        +-- setLoop()
        +-- setEffectiveWeight()
        +-- crossFadeTo()
```

## Basic Usage

```javascript
const mixer = new THREE.AnimationMixer(model);

// Play animation
const clip = THREE.AnimationClip.findByName(model.animations, 'walk');
const action = mixer.clipAction(clip);
action.play();

// In render loop
function animate() {
  const delta = clock.getDelta();
  mixer.update(delta);
}
```

## Animation Blending

```javascript
const walkAction = mixer.clipAction(walkClip);
const runAction = mixer.clipAction(runClip);

// Start both
walkAction.play();
runAction.play();

// Crossfade from walk to run
walkAction.crossFadeTo(runAction, 0.5, true);

// Or manual weight control
walkAction.setEffectiveWeight(0.7);
runAction.setEffectiveWeight(0.3);
```

## Morph Targets

```javascript
// Access morph targets
const mesh = model.getObjectByName('Face');
const morphTargetDictionary = mesh.morphTargetDictionary;
const morphTargetInfluences = mesh.morphTargetInfluences;

// Animate manually
morphTargetInfluences[morphTargetDictionary['smile']] = 0.5;

// Or use AnimationClip
const smileTrack = new THREE.NumberKeyframeTrack(
  'Face.morphTargetInfluences[smile]',
  [0, 1, 2],     // times
  [0, 1, 0]      // values
);
const clip = new THREE.AnimationClip('SmileAnim', 2, [smileTrack]);
```

## Skeletal Animation

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

  // Find SkinnedMesh
  model.traverse((child) => {
    if (child.isSkinnedMesh) {
      // Access bones
      const skeleton = child.skeleton;
      const bones = skeleton.bones;

      // Manipulate bone directly
      const head = bones.find(b => b.name === 'Head');
      head.rotation.y = Math.PI / 4;
    }
  });
});
```

## Loop Modes

```javascript
action.setLoop(THREE.LoopOnce);       // Play once
action.setLoop(THREE.LoopRepeat);     // Repeat forever (default)
action.setLoop(THREE.LoopPingPong);   // Alternate direction
action.setLoop(THREE.LoopRepeat, 3);  // Repeat 3 times

// Clamp at end
action.clampWhenFinished = true;
```

## Events

```javascript
mixer.addEventListener('finished', (e) => {
  console.log('Animation finished:', e.action.getClip().name);
});

mixer.addEventListener('loop', (e) => {
  console.log('Loop:', e.action.getClip().name);
});
```

## Time Scale & Duration

```javascript
// Speed control
action.setEffectiveTimeScale(2);  // Double speed
action.setEffectiveTimeScale(0.5); // Half speed
action.setEffectiveTimeScale(-1); // Reverse

// Duration
const duration = clip.duration;

// Set to specific time
action.time = 1.5;

// Set to percentage
action.time = duration * 0.5; // 50%
```

## Creating Custom Animations

```javascript
// Position animation
const positionTrack = new THREE.VectorKeyframeTrack(
  '.position',
  [0, 1, 2],                           // times
  [0, 0, 0, 0, 5, 0, 0, 0, 0]         // positions (x,y,z for each keyframe)
);

// Rotation animation (quaternion)
const rotationTrack = new THREE.QuaternionKeyframeTrack(
  '.quaternion',
  [0, 1],
  [0, 0, 0, 1, 0, 0.707, 0, 0.707]   // quaternions
);

// Color animation
const colorTrack = new THREE.ColorKeyframeTrack(
  '.material.color',
  [0, 1],
  [1, 0, 0, 0, 0, 1]                  // red to blue
);

const clip = new THREE.AnimationClip('custom', 2, [
  positionTrack,
  rotationTrack,
  colorTrack
]);
```

## Best Practices

1. **Single Mixer**: Use one AnimationMixer per animated object hierarchy

2. **Delta Time**: Always pass delta time to mixer.update()

3. **Weight Management**: Reset weights when switching animations

4. **Cleanup**: Stop actions and remove mixers when disposing objects

5. **Preload**: Create all AnimationActions on init, not during runtime

6. **Performance**: Use animation.optimize() for production

```javascript
// Optimize animation data
clip.optimize();

// Cleanup
action.stop();
mixer.stopAllAction();
mixer.uncacheRoot(model);
```

## References

- [Three.js Animation System](https://threejs.org/docs/#manual/en/introduction/Animation-system)
- [Three.js AnimationMixer](https://threejs.org/docs/#api/en/animation/AnimationMixer)

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

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

Все правила IDE по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
threejs-animation cesartevisual Скилл threejs-animation для Claude Code помогает создавать и настраивать анимацию в Three.js. Включается при работе с клипами, скелетной анимацией и прокруткой. CX Codex +1 753установок isometric-animation iart-ai Скилл isometric-animation для изометрических и 2.5D-анимаций: стопки слоёв, выдавленные блоки, взрывные схемы и лёгкий дрейф камеры. Собирается в один HTML-файл без сборки. CX Codex +1 2 900установок particle-system iart-ai Скилл particle-system для ИИ-кодинга, который помогает агенту собрать систему частиц: конфетти, снег, дым, искры, сетку из точек и GPU-частицы на Three.js Points. CX Codex +1 2 300установок r3f-animation EnzeD Скилл r3f-animation для плавной анимации 3D-объектов в React Three Fiber через useFrame, damping и GLTF-клипы. Подходит для процедурного движения, переходов между состояниями и управления анимацией по запросу. CX Codex +1 2 300установок build-game-monster-system MengTo Скилл build-game-monster-system для Claude Code собирает монстров как игровые runtime-ассеты с ригами, хитбоксами и анимационными состояниями. Запускается при создании, аудите или рефакторинге системы врагов в Three.js-проекте. CX Codex +1 1 600установок core-3d-animation-integration Claude Design Skillstack Субагент core-3d-animation-integration для Claude, который разбирает проекты, где three.js, GSAP, React Three Fiber, Motion и Babylon.js встречаются в одном коде. CX Codex ★ 1 428звёзд репо

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

Весь набор →
audio-spatial Правило audio-spatial для Claude Code задаёт шаблоны настройки 3D-звука в Three.js: позиционирование источников, затухание и реакцию на действия пользователя. CX Codex +1 ★ 4 719звёзд репо 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звёзд репо gltf-loading-optimization Правило gltf-loading-optimization для Claude Code содержит сниппеты и команды для загрузки glTF в Three.js, настройки декодеров, прогресса, ленивой подгрузки и сжатия моделей. 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звёзд репо

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

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