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 the .glb model, such as character walks or door opens. Use Tween for procedural move, rotate, or scale between two values, and a custom engine.addSystem for per-frame control.

playSingleAnimation returns false when the clip name is not present in the entity's Animator.states array, with no console warning. Add the clip to states at Animator.create time or lazily push missing states before calling it.

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

Poll the read-only Animator.get() each frame and edge-detect the state's playing flag flipping from true to false. Avoid getClip or getMutable in per-frame reads since they mark the component dirty and cause serialization overhead.

Attach TweenSequence.create with an empty sequence array and loop set to TweenLoop.TL_YOYO on an entity that already has a plain Tween. This loops the base tween itself; use TL_RESTART for one-directional repeats like scrolling textures.