animations-tweens
Installation
SKILL.md
Animations and Tweens in Decentraland
Authoring split
Animator, Tween, and TweenSequence are all supported in main-entities.ts — declare the entity, its visual components, and its initial animation state in the literal. Switch clips or replace tweens at runtime in src/index.ts via getMutable.
When to Use Which Animation Approach
| Need | Approach | When |
|---|---|---|
| Play animation baked into a .glb model | Animator |
Character walks, door opens, flag waves — any animation created in Blender/Maya |
| Move/rotate/scale an entity smoothly | Tween |
Sliding doors, floating platforms, growing objects — procedural A-to-B motion |
| Chain multiple animations in sequence | TweenSequence |
Patrol paths, multi-step doors, complex choreography |
| Continuous per-frame control | engine.addSystem() |
Physics-like motion, following a target, custom easing |
Decision flow:
- Does the .glb model already have the animation? →
Animator - Is it a simple move/rotate/scale between two values? →
Tween - Do you need frame-by-frame control or custom math? → System with
dt