ECSM

Easy to use template based C++ Entity Component System Manager library.

The ECS pattern, or Entity-Component-System pattern, is a design pattern commonly used in game development and simulation software. It is a way to organize and manage the behavior and data of objects within a system. The ECS pattern is particularly useful for systems with a large number of entities that can have varying and dynamic sets of attributes.

See the documentation

Features

• Straightforward template architecture
• Custom event creation support
• Cache friendly linear pools
• Acceptable compilation time
• Fast component iteration
• Fast entity component access
• Singleton class pattern

Usage example

using namespace ecsm;

struct RigidBodyComponent final : public Component
{
    float size = 0.0f;
};

class PhysicsSystem final : public ComponentSystem<RigidBodyComponent, false>
{
    PhysicsSystem()
    {
        ECSM_SUBSCRIBE_TO_EVENT("Update", PhysicsSystem::update);
    }
    ~PhysicsSystem() final
    {
        if (Manager::get()->isRunning())
            ECSM_UNSUBSCRIBE_FROM_EVENT("Update", PhysicsSystem::update);
    }

    void copyComponent(View<Component> source, View<Component> destination) final
    {
        const auto sourceView = View<RigidBodyComponent>(source);
        auto destinationView = View<RigidBodyComponent>(destination);
        destinationView->size = sourceView->size;
    }

    void update()
    {
        // Process components...
    }

    friend class ecsm::Manager;
};

void ecsmExample()
{
    auto manager = new ecsm::Manager();
    manager->createSystem<PhysicsSystem>();
    manager->createSystem<GraphicsSystem>(false, 123); // System arguments
    // ...

    manager->initialize();

    auto rigidBody = manager->createEntity();
    auto rigidBodyView = manager->add<RigidBodyComponent>(rigidBody);
    rigidBodyView->size = 1.0f;

    manager->start();

    delete manager;
}

Supported operating systems

• Windows
• macOS
• Ubuntu (Linux)

Build requirements

• C++17 compiler
• Git 2.30+
• CMake 3.16+

Use building instructions to install all required tools and libraries.

CMake options

Name	Description	Default value
ECSM_BUILD_SHARED	Build ECSM shared library	ON
ECSM_BUILD_TESTS	Build ECSM library tests	ON

CMake targets

Name	Description	Windows	macOS	Linux
ecsm-static	Static ECSM library	.lib	.a	.a
ecsm-shared	Dynamic ECSM library	.dll	.dylib	.so

Cloning

git clone https://github.com/cfnptr/ecsm

Building

• Windows: ./scripts/build-release.bat
• macOS / Ubuntu: ./scripts/build-release.sh