bevy-undo

This crate makes it easy to use the "undo" action on bevy.

Usage

Basic

If you generate OnUndo in commands beforehand, the latest OnUndo callback will be called when Undo is generated. Each of these components can be easily created with the on_undo and undo methods.

Here is a simple example that prints Undo!!!!!! when you press the R key.when input key R

examples/simple.rs

``rust fn main() { App::new() .add_plugins(DefaultPlugins) .add_plugins(UndoPlugin) // Please addUndoPlugin` .addsystems(Startup, setup) .addsystems(Update, keycode_undo) .run(); }

fn setup( mut commands: Commands ) { commands .on_undo(|commands: Commands| { println!("Undo!!!!!!"); }); }

fn keycodeundo( mut commands: Commands, key: Res>, ) { if key.justpressed(KeyCode::R) { commands.undo(); } } ```

You can add one or more entities to the argument of on_undo. (maximum 12)

examples/extension/commandsonundo_builder.rs

```rust fn setup( mut commands: Commands ) { let id1 = commands .spawnempty() .id(); let id2 = commands .spawnempty() .id(); let id3 = commands .spawn_empty() .id();

commands
    .on_undo_builder()
    .add_entity(id1)
    .add_entity(id2)
    .add_entity(id3)
    .on_undo(|commands: Commands, (entity1, entity2, entity3)| {
        println!("undo entity1 = {entity1:?} entity2 = {entity2:?} entity3 = {entity3:?}");
    });

}

```

In the case of EntityCommand, the Entity associated with itself is added as an argument.

```rust fn setup(mut commands: Commands) { commands .spawnempty() .onundo(|commands, entity1| {});

// The code above can be replaced with:
let id1 = commands
    .spawn_empty()
    .id();
commands
    .on_undo_builder()
    .add_entity(id1)
    .on_undo(|commands, entity1| {});

} ```

Processing

Undo is ignored while there is one or more Processing in the world.

See examples/tween/sprite_move.rs for details.

Examples

here

Features

tween

Add methods to bevy_tweening for undo operations, callbacks on animation completion, etc

Compatible Bevy versions

| this crate | bevy | |------------|--------| | 0.1.0 | 0.11.0 |