bevy 0.19.0

A refreshingly simple data-driven game engine and app framework
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41

---
title: Delayed Commands
authors: ["@Runi-c"]
pull_requests: [23090]
---

Scheduling things to happen some time in the future is a common and useful tool in game development. For example, gameplay logic, audio cues, or VFX.

While this was previously possible through careful use of timers,
getting the details right was surprisingly tricky and naive solutions were heavy on boilerplate.

Now, you can simply delay arbitrary commands to be executed later using the [`DelayedCommandsExt`] extension trait.

```rust
fn delayed_spawn(mut commands: Commands) {
    commands.delayed().secs(1.0).spawn(DummyComponent);
}

fn delayed_spawn_then_insert(mut commands: Commands) {
    let mut delayed = commands.delayed();
    let entity = delayed.secs(0.5).spawn_empty().id();
    delayed.secs(1.5).entity(entity).insert(DummyComponent);
}
```

See:

- [`DelayedCommands`]
  - [`delayed`]
  - [`secs`]

Note that this does not have a built-in, blessed cancellation mechanism yet.
We recommend embedding the originating [`Entity`] into the command if you want to "cancel" the action if that entity dies or is despawned. (make the command early-return)

<!-- TODO: Add example -->

[`Entity`]: https://docs.rs/bevy/0.19.0/bevy/ecs/entity/struct.Entity.html
[`DelayedCommandsExt`]: https://docs.rs/bevy/0.19.0/bevy/time/delayed_commands/trait.DelayedCommandsExt.html
[`DelayedCommands`]: https://docs.rs/bevy/0.19.0/bevy/time/delayed_commands/struct.DelayedCommands.html
[`delayed`]: https://docs.rs/bevy/0.19.0/bevy/time/delayed_commands/struct.DelayedCommands.html#method.delayed
[`secs`]: https://docs.rs/bevy/0.19.0/bevy/time/delayed_commands/struct.DelayedCommands.html#method.secs