sky_ecs 0.1.3

High-performance typed chunk-based ECS for Rust
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

//! Purpose: Package configuration and systems into a reusable ECS plugin.
//! Prerequisites: step_05_systems; step_08_dynamic is optional.
//! APIs: Plugin, PluginResult, World::install, World::has_plugin.
//! Run: cargo run -p sky_ecs --example step_09_plugin

use sky_ecs::{Plugin, PluginResult, Res, Time, Update, View, World};

#[derive(Debug)]
struct Position(f32);

struct Velocity(f32);

struct MovementConfig {
    speed_scale: f32,
}

struct MovementPlugin {
    speed_scale: f32,
}

fn movement(
    bodies: View<(&mut Position, &Velocity)>,
    config: Res<MovementConfig>,
    time: Res<Time>,
) {
    bodies.for_each(|(position, velocity)| {
        position.0 += velocity.0 * config.speed_scale * time.delta;
    });
}

impl Plugin for MovementPlugin {
    fn name(&self) -> &'static str {
        "MovementPlugin"
    }

    fn install(self, world: &mut World) -> PluginResult {
        world.insert_resource(MovementConfig {
            speed_scale: self.speed_scale,
        });
        world.stage(Update).add(movement);
        Ok(())
    }
}

fn main() {
    let mut world = World::new();
    let entity = world.spawn((Position(0.0), Velocity(3.0)));

    world.install(MovementPlugin { speed_scale: 2.0 }).unwrap();
    assert!(world.has_plugin::<MovementPlugin>());

    let duplicate = world.install(MovementPlugin { speed_scale: 99.0 });
    assert!(duplicate.is_err());
    assert_eq!(
        world.get_resource::<MovementConfig>().unwrap().speed_scale,
        2.0
    );

    world.tick_with_delta(0.5).unwrap();
    assert_eq!(world.get::<Position>(entity).unwrap().0, 3.0);
    world.shutdown();

    println!("step 09: plugin configuration moved the entity to x=3");
}