Butterfly

import { createAsset } from 'https://gaitkit.com/cdn/butterfly.mjs';

const butterfly = createAsset();
scene.add(butterfly);                      // rests on y = 0, front faces +Z

let dist = 0;
renderer.setAnimationLoop(() => {
  dist += speed * clock.getDelta();
  butterfly.position.set(0, groundY + butterfly.userData.altitude, dist);
  butterfly.userData.tick(dist);            // wings beat with the distance
  renderer.render(scene, camera);
});

import { useMemo, useRef } from 'react';
import { useFrame } from '@react-three/fiber';
import { createAsset } from 'https://gaitkit.com/cdn/butterfly.mjs';

export function Butterfly({ speed = 1 }) {
  const model = useMemo(() => createAsset(), []);
  const dist = useRef(0);
  useFrame((_, dt) => {
    dist.current += speed * dt;
    model.position.set(0, groundY + model.userData.altitude, dist.current);
    model.userData.tick(dist.current);            // wings beat with the distance
  });
  return <primitive object={model} />;
}

# Import butterfly.glb (download below). It carries an in-place "Loop" animation.
@onready var anim: AnimationPlayer = $Butterfly/AnimationPlayer

func _physics_process(delta):
    velocity = transform.basis.z * speed
    move_and_slide()
    anim.play("Loop")
    anim.speed_scale = speed / 0.05   # one Loop = 0.05 m of travel

// Import butterfly.glb with glTFast (com.unity.cloud.gltfast).
animator.Play("Loop");
animator.speed = speed / 0.05   // one Loop = 0.05 m of travel