Svelto Entity Component System 2.7
Real Entity-Component-System for c#. Enables to write encapsulated, decoupled, maintainable, highly efficient, data oriented, cache friendly, multi-threaded, code without pain. Although the framework is platform agnostic (compatible with .net 3.5, .net 4.5 and .net standard 2.0), it comes with several Unity extensions.
Why using Svelto.ECS with Unity?
Svelto.ECS wasn’t born just from the needs of a large team using Unity on several projects, but also as result of years of reasoning behind software engineering applied to game development and that’s why the main Svelto.ECS goals are currently different than the ones set by Unity ECS. They may converge one day, but at the moment they are different enough to justify the on going development of Svelto.ECS. The biggest difference is that Svelto.ECS primary objective is not performance. Performance gain is just one of the benefits in using Svelto.ECS, as the ECS design in general helps to write cache-friendly code. All that said the main reasons why Svelto.ECS has been written orbit around the shifting of paradigm from Object Oriented Programming, the consequent improvement of the code design and maintainability, the approachability by junior programmers that won’t need to worry too much about the architecture and can focus on the solution of the problems thanks to the rigid directions that the framework gives. Svelto.ECS is the result of years of iterating the ECS design applied to real game development, with the intent to be "junior coder proof".
You can find a working example to learn how to use the framework here:
- Survival Example (Unity): https://github.com/sebas77/Svelto-ECS-Example (including article)
- Vanilla Example (.Net Standard/.Net Core): https://github.com/sebas77/Svelto.ECS.Examples.Vanilla (including article)
Svelto users articles (note they may use outdated version of Svelto):
- https://eagergames.wordpress.com/category/ecs/ (Dario Oliveri)
- https://blogs.msdn.microsoft.com/uk_faculty_connection/2018/05/08/entity-component-system-in-unity-a-tutorial/ (Lee Stott)
If you write an article about Svelto, please let me know, I will add it here!
- http://www.sebaslab.com/svelto-ecs-2-5-and-allocation-0-code/ (shows what's changed compared to 2.0)
- http://www.sebaslab.com/svelto-ecs-2-0-almost-production-ready/ (shows what's changed compared to 1.0)
- http://www.sebaslab.com/svelto-ecs-svelto-tasks-to-write-data-oriented-cache-friendly-multi-threaded-code-in-unity/ (since I don't like the example much, I didn't update the code, but the article is still valid)
Theory related articles (please read them to understand why I think ECS is great to write maintainable code):
Note: I included the IoC articles just to show how I shifted over the years from using an IoC container to use an ECS framework and the rationale behind its adoption.
The perfect companion for Svelto.ECS is Svelto.Tasks to run the logic of the Systems even on other threads!
Unity official forum thread:
NED-Studio Svelto ECS inspector (WIP)
How to clone
The folders Svelto.ECS, Svelto.Tasks and Svelto.Common, where present, are submodules pointing to the relavite repositories. If you find them empty, you need to update them through the submodule command. Check some instructions here: https://github.com/sebas77/Svelto.ECS.Vanilla.Example/wiki
Note: don't beat yourself up if you find Svelto.ECS hard to use at first. The framework is very light in features, but it forces the use of a new coding paradigm and shifting code paradigm is hard! I will try to clarify all the concepts writing more and more articles
In case of bugs
Best option is to fork and clone https://github.com/sebas77/Svelto.ECS.Tests, add a new test to reproduce the problem and request a pull. Then open a github, I come here pretty often :). Also feel free to contact me on twitter or leave comments on the blog!
It needs love and as far as I understood, anyone can edit it. Feel free to do so if you have a good understanding of Svelto!
I like the project, how can I help?
Hey thanks a lot for considering this. You can help in two ways. First one is with the documentation, updating the wiki or writing your own articles. The second one is helping me coding new features. Svelto.ECS has all the features needed to make a game with the ECS pattern, but the design can very likely still improved and tweaked, but I hope I won't need to add any major features anymore or undergo any major refactoring (that happened already several times since I wrote this paragraph). I'd love to have some visual tools, at least for Unity, but that probably I won't have the time to develop them. What I have in mind is to use reflection or static analisis to analyze the code and visualize the engines, entities and maybe their relations. The Context are also designed to be able to be substituted with config files, so it would be theoretically possible to generate EnginesRoots, add Engines, inject Sequencers automatically instead to do it manually in the Composition Root.
Svelto Framework is used to develop the following products(*):
*if you want your products made with Svelto here, just send me an email or whatever, I'll be super happy to add them.
Note: Dear Svelto Users : Although I am committed to help you and write articles as much as I can, I will never be able to keep all the documentation up to date. If you are a happy svelto user and you want to contribute, please feel free to update the github wiki!