flecs_ecs 0.2.1

Rust API for the C/CPP flecs ECS library <https://github.com/SanderMertens/flecs>
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

// Flecs script is a simple language for loading entities into flecs. It has as 
// advantage that it natively integrates with Flecs features such as the
// reflection addon (meta), prefabs, hierarchies and relationships.
//
// The syntax has been designed to make it convenient for use cases like:
// - configuration files
// - asset descriptions (such as prefabs)
// - entity hierarchies/scene graphs
//
// To see what the result of parsing this file looks like, copy the code and
// paste it into the editor at https://flecs.dev/explorer
//
// To load this file yourself, call `World::run_file("hello_world.flecs");`

// Create tags
Planet { }
SpaceShip { }
Freighter { }
Faction { }
FasterThanLight { }
Engine { }

// This creates an entity my_spaceship with the SpaceShip tag.
my_spaceship { SpaceShip }

// Create Earth
Earth { Planet }

// By opening a scope multiple components/tags can be added to the same entity
// without having to repeat the entity name.
my_spaceship {
  Freighter
  (Faction, Earth) // Relationships use the same syntax as the query DSL
}

// A scope can also be used to add child entities. Child entities and components
// can be added in the same scope.
my_spaceship {
  FasterThanLight

  // This creates an engine entity with my_spaceship as parent
  engine {
    Engine // The Engine tag is added to my_spaceship.engine
  }
}

// The dot notation can be used to refer to nested entities
my_spaceship.engine {
  FasterThanLight
}