zaferozerr / ecspanse

Entity Component System (ECS) library for Elixir, offering a suite of features including: flexible queries with multiple filters, dynamic bidirectional relationships, versatile tagging capabilities, system event subscriptions, or asynchronous system execution.

Ecspanse

Ecspanse is an Entity Component System (ECS) framework for Elixir.

Ecspanse is not a game engine, but a flexible foundation for managing state and building logic offering features like:

• flexible queries with multiple filters
• dynamic bidirectional relationships
• versatile tagging capabilities
• system event subscriptions
• asynchronous system execution

The full documentation for the Ecspanse project is available on HexDocs.

Ecspanse draws inspiration from the API of bevy_ecs. However, while Bevy is a comprehensive game engine, Ecspanse focuses on providing an Entity Component System (ECS) library in Elixir. The concepts described in the unofficial cheatbook also served as valuable references during development.

Please note that Ecspanse does not claim to be a Bevy equivalent in Elixir. If you're seeking a fully-featured ECS game library, please give Bevy a try.

Installation

Refer to the Getting Started guide for installation instructions.

Getting Started

The step-by-step Tutorial guides you through building a simple game, introducing key features of the framework along the way.

Demo Projects

The Ecspanse Demo

This is the code used in the Ecspanse Tutorial. You can find it on GitHub.

I've Seen Things

This multiplayer game was built with Ecspanse during the library's development. Check out its GitHub repository. The game is currently hosted on fly.io and can be played HERE.

To Do

• Implement persistence: Develop a flexible and selective method for saving and loading components and resources.
• Expand testing beyond happy path scenarios.
• Improve documentation.

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.