animations-tweens

Create an Animator component with a states array listing each clip, then call Animator.playSingleAnimation(entity, clipName). The clip must already exist in states or the call silently returns false when the Animator was authored in code.

Use Animator when the animation is baked into a .glb model, such as a character walk or door open clip. Use Tween for procedural A-to-B motion of position, rotation, or scale, and a custom engine.addSystem for per-frame control.

playSingleAnimation returns false and does nothing when the clip name is not present in the entity's Animator.states array. Add the clip to states at Animator.create time or use a lazy-registration wrapper that appends missing states.

Without an Animator component, the renderer autoplays one clip from the GLB and holds its final frame, so doors or lids can spawn open. Add Animator.create with the intended default clip set to playing, or hold frame 0 with speed 0.

For tweens, call tweenSystem.tweenCompleted(entity) inside an engine.addSystem. For non-looping clips, poll the read-only Animator.get and edge-detect the playing flag flipping from true to false.

An omitted start in Tween.Mode.Move is treated as (0,0,0), so the entity teleports to the scene origin before moving. Always pass Transform.get(entity).position as start to move from the live current position.