Heron

A sprite sheet animation plugin for bevy

Features

• A SpriteSheetAnimation component to automatically update the indices of the TextureAtlasSprite in the same entity
• An animation is playing if, and only if a Play component is present in the entity
  • Simply remove/insert the Play component to pause/resume an animation
• The animation can be defined from an index-range, or an arbitrary list of indices
• Each frame may have a different duration

Usage

fn main() {
  App::build()
          .add_plugins(DefaultPlugins)
          .add_plugin(AnimationPlugin) // <-- Add the plugin
          .add_startup_system(spawn.system())
          .run();
}

fn spawn(
  mut commands: Commands,
  asset_server: Res<AssetServer>,
  mut textures: ResMut<Assets<TextureAtlas>>,
) {
  // Don't forget the camera ;-)
  commands.spawn_bundle(OrthographicCameraBundle::new_2d());

  commands
          // Spawn a bevy sprite-sheet
          .spawn_bundle(SpriteSheetBundle {
            texture_atlas: textures.add(TextureAtlas::from_grid(asset_server.load("coin.png"), Vec2::new(16.0, 16.0), 5, 1)),
            transform: Transform::from_scale(Vec3::splat(10.0)),
            ..Default::default()
          })
          // Insert the animation component
          // Here we use an index-range (from 0 to 4) where each frame has the same duration
          .insert(SpriteSheetAnimation::from_range(0..=4, Duration::from_millis(100)))
          // Start the animation immediately. Remove this component in order to pause the animation.
          .insert(Play);
}

Here is the result:

For more details see the documentation

Installation

Add to Cargo.toml:

benimator = "0.1.0"

Bevy Version Compatibility

Contribute / Contact

You can open issues/discussions here, or you can discuss with me (Jomag#2675) in the bevy discord