ECS

Elixir Entity-Component System game engine

Installation

Add ecs to your list of dependencies in mix.exs:

def deps do
  [{:ecs, "~> 0.3.0"}]
end

Example

# Define a simple component for containing a "name" value.
defmodule Component.Name do
  defstruct value: nil

  def new(name), do: %__MODULE__{value: name}
end

# Define a player entity that will contain components.
defmodule Entity.Player do
  def new(name) do
    ECS.Entity.new([
      Component.Name.new(name)
    ])
  end
end

# Define a system that prints out names of entities that have name components.
defmodule System.DisplayName do
  @behaviour ECS.System
  alias Component.Name

  def component_types, do: [Name]

  def perform(entity) do
    entity
    |> ECS.Entity.get(Name)
    |> Map.get(:value)
    |> IO.puts

    entity
  end
end

# Take our modules for a spin!
player = Entity.Player.new("Josh")
ECS.System.run([System.DisplayName], [player])