bevy_spawnable 0.5.1

tiny spawn utility for Bevy, to encapsulate spawn logic
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
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

# bevy_spawnable


[![Crates.io](https://img.shields.io/crates/v/bevy_spawnable)](https://crates.io/crates/bevy_spawnable)
[![Docs.rs](https://docs.rs/bevy_spawnable/badge.svg)](https://docs.rs/bevy_spawnable)
[![License](https://img.shields.io/crates/l/bevy_spawnable)](LICENSE)

A tiny spawn utility for bevy. This crate will helps you:

- encapsulate the spawn logic into a single function or object.
- no worry about builder is `Commands` or `ChildBuilder`.

You can use this crate as a kind of like Unity's prefab as a code object, or builder to create entities which have complex structure.

( If you need more detailed spawn utility, consider [moonshine_spawn](https://github.com/Zeenobit/moonshine_spawn) as an alternative. )

## Usage


see [examples](examples)

### simple.rs


```rust
use bevy::{ecs::system::EntityCommands, prelude::*};
use bevy_spawnable::*;

fn main() {
    App::new()
        .add_plugins(DefaultPlugins)
        .add_systems(Startup, setup)
        .run();
}

pub struct Hello {
    pub text: String
}

impl Spawnable for Hello {
    fn spawn<'a>(&mut self, builder: &'a mut impl GenericBuilder) -> EntityCommands<'a> {
        let mut e = builder.spawn(Node {
            width: Val::Percent(100.),
            height: Val::Percent(100.),
            flex_direction: FlexDirection::Column,
            justify_content: JustifyContent::Center,
            align_items: AlignItems::Center,
            ..default()
        });

        e.with_children(|root| {
            root.spawn((
                Text::new(self.text.clone()),
                TextFont {
                    font_size: 50.0,
                    ..default()
                },
                TextColor (
                    Color::WHITE.into()
                ),
                TextLayout::new_with_justify(JustifyText::Center)
            ));
        });

        e
    }}

fn setup(mut commands: Commands) {
    commands.spawn(Camera2d::default());

    commands.spawns(&mut Hello {
        text: "Hello, Bevy!".to_string()
    });
}
```

## Versions


| bevy | bevy_spawnable      |
|------|---------------------|
| 0.17 | 0.5                 |
| 0.16 | 0.4                 |
| 0.15 | 0.3                 |
| 0.14 | 0.2                 |
| 0.13 | 0.1                 |

## License


Dual licensed under WTFPL and/or 0BSD.