animation-system — правило для Claude Code: анимация Three.js
Правило animation-system объясняет систему анимации Three.js: от запуска и смешивания клипов до морфинга и управления костями. Пригодится при работе с анимированными 3D-моделями.
MIT ★ 4 719 обновлён 2026-10-24
.claude/rules/animation-system.mdЧто делает animation-system
В руководстве разобраны AnimationMixer, AnimationClip, KeyframeTrack и AnimationAction: как запустить клип, обновлять микшер с учётом времени кадра и плавно переключаться между анимациями. Также описаны режимы повтора, скорость воспроизведения и события завершения или цикла.
Отдельные примеры показывают ручное управление морф-целями, анимацию через ключевые кадры и изменение костей у SkinnedMesh. Можно собрать собственный клип для позиции, поворота или цвета. Для корректного обновления микшеру нужно передавать delta time; при удалении модели следует останавливать действия и очищать ссылки микшера.
Какие задачи решает
- запустить клип анимации модели
- смешать ходьбу и бег через crossfade
- анимировать выражение лица морф-целями
- изменить поворот кости в скелете
- создать клип для позиции, поворота или цвета
Примеры запросов агенту
- Объясни, как запустить клип
walkчерезAnimationMixerи обновлять его в цикле рендера. - Покажи, как плавно переключить модель с ходьбы на бег.
- Составь пример анимации улыбки через
morphTargetInfluences.
Как установить animation-system
Вручную: положить файлы
.claude/rules/animation-system.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/animation-system.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/animation-system.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/animation-system.mdВручную: положить файлы
.clinerules/animation-system.mdПо шагам, с командами для каждой платформы: 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