README.md

Entity System

A fast and compact entity system in C++. Its main features are:

• Really fast.
• Tries hard to conserve memory.
• Components can be defined at runtime.
• Plays nice with existing code: multiple components can have the same type, and there's no need to inherit them from a base class.

Example

#include <es/entity.hpp>
#include <es/component.hpp>
#include <es/storage.hpp>


main()
{
    using namespace es;
    typedef hexa::vector3<float> vec;

    storage s;

    // Register some components.
    auto health   (s.register_component<float>("health"));
    auto pos      (s.register_component<vec>("position"));
    auto name     (s.register_component<std::string>("name"));

    // Create some new, empty entities.
    entity player (s.new_entity());
    entity bullet (s.new_entity());

    // Assign some data to the entities.
    s.set(player, health, 20.0f);
    s.set(player, name,   std::string("Timmy"));
    s.set(player, pos,    vec(2, 5, 7));

    s.set(bullet, pos,    vec(4, 8, -1));

    // Retrieve the data.
    std::cout << "Player: " << s.get<std::string>(player, name) << std::endl;

    // Build a "System" that moves everything with a position diagonally.
    s.for_each<vec>(pos, [](storage::iterator, vec& p)
    {
        p += vec(1, 1, 1);
    });
}

Binary packages

LibES can be installed from a PPA:

$ add-apt-repository ppa:nocte/hexahedra
$ apt-get update
$ apt-get install libes1-dev

License

This library is released under the terms and conditions of the MIT License. See the file 'LICENSE' for more information.

Build status

This project uses Travis CI to build and run the unit tests on different compilers automatically.