godot-ecs

Lightweight ecs framework written with gdscript.

Features

• Lightweight and high-performance.
• Components support serialization and deserialization.
• Easy to use.

How To Use

• Copy the 'ecs' directory to any location within your Godot project.
• Begin your ECS coding journey with the following code:

# create ecs world
var world = ECSWorld.new()

# create entity
var e = world.create_entity()

# add component
e.add_component("c1", ECSComponent.new())
e.add_component("c2", ECSComponent.new())
e.add_component("c3", ECSComponent.new())

# add system
world.add_system("s1", ECSSystem.new())
world.add_system("s2", ECSSystem.new())
world.add_system("s3", ECSSystem.new())

# add command
world.add_command("my_command", ECSCommand)

# send notification
world.notify("my_notification", with_param)
world.notify("my_command", with_param)

# view components
for c in world.view("c1"):
    print(c)

# multi view components
for dict in world.multi_view(["c1", "c2", "c3"])
    print(dict)

# view components with filter
for c in world.view("c1", func(c):
    return true):
    print(c)

# multi view components with filter
for dict in world.multi_view(["c1", "c2"], func(dict: Dictionary):
    return true):
    print(dict)
    
# serialize components
var serialize_dict = {}
for c in component_list:
    var e: ECSEntity = c.entity()
    var all_components = e.get_components()
    var entity_data = {}
    for cc in all_components:
        var data = {}
        cc.save( data )
        entity_data[ cc.name() ] = data
    var entity_id = e.id()
    serialize_dict[ entity_id ] = entity_data

printt("this is entity serialize data", serialize_dict)