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.

Requirements

OTP-25.0 and above is required to use Ecspanse.

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

• 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.