EcsRx
Search…
Setup
If you are using Monogame or Unity you can just go and get the platform specific helpers which will out the box provide you most of the infrastructure and setup required to get going, so go look there.
If you are not using Unity or Monogame and want to pioneer into a new territory then its just a case of setting up the bits that are needed for the core parts of the system to run.
Pre build infrastructure or not?
Out the box EcsRx comes with a load of infrastructure classes which simplify setup, if you are happy to use that as a basis for setup then your job becomes a bit simpler.
There is also a whole section in these docs around the infrastructure and how to use the application and other classes within there in common scenarios.
YES I WANT ALL THE INFRASTRUCTURE PLX PLX
A wise choice so to start with its advised that you take:
EcsRxEcsRx.InfrastructureEcsRx.Plugins.ReactiveSystemsEcsRx.Plugins.Views
This will provide the basic classes for you to extend, however one fundamental problem is that the infrastructure expects you to be using a DI framework. It doesn't really care which DI framework as it provides an interface for you to implement and then consume that in your own
EcsRxApplication implementation.So here are the main bits you need:
- Implement
IDependencyContainerfor your DI framework of choice. Here is a Ninject one from examples - Implement your own
EcsRxApplicationclass, giving it anIDependencyContainerimplementation to use. Here is one from examples - Extend your custom
EcsRxApplicationimplementation for each logical app you need to make, as shown in the EcsRx console examples
There are pre-made DI implementations for Ninject and Zenject so if you can use one of those on your platform GREAT! if not then just pick a DI framework of choice and implement your own handler for it (using the ninject one as an example to base it off).
It is worth noting here that this is EXACTLY how the examples work in this project so its worth cracking them open to see how its all done, but the same principals can be applied to your own applications.
NOOOPE! I dont care for your design patterns sir, just let me get going
Ok captain, if you just want to get things going with minimum effort then I would just get the core lib and manually instantiate everything that is needed.
This is like the most bare bones setup I would advise:
1
public abstract class EcsRxApplication
2
{
3
public ISystemExecutor SystemExecutor { get; }
4
public IEventSystem EventSystem { get; }
5
public IObservableGroupManager ObservableGroupManager { get; }
6
public IEntityDatabase EntityDatabase { get; }
7
8
protected EcsRxApplication()
9
{
10
// For sending events around
11
EventSystem = new EventSystem(new MessageBroker());
12
13
// For mapping component types to underlying indexes
14
var componentTypeAssigner = new DefaultComponentTypeAssigner();
15
var allComponents = componentTypeAssigner.GenerateComponentLookups();
16
17
var componentLookup = new ComponentTypeLookup(allComponents);
18
// For interacting with the component databases
19
var componentDatabase = new ComponentDatabase(componentLookup);
20
var componentRepository = new ComponentRepository(componentLookup, componentDatabase);
21
22
// For creating entities, collections, observable groups and managing Ids
23
var entityFactory = new DefaultEntityFactory(new IdPool(), componentRepository);
24
var entityCollectionFactory = new DefaultEntityCollectionFactory(entityFactory);
25
EntityDatabase = new EntityDatabase(entityFactory);
26
var observableGroupFactory = new DefaultObservableObservableGroupFactory();
27
ObservableGroupManager = new EntityCollectionManager(observableGroupFactory, entityDatabase, componentLookup);
28
29
// All system handlers for the system types you want to support
30
var manualSystemHandler = new ManualSystemHandler(ObservableGroupManager);
31
var basicSystemHandler = new BasicSystemHandler(ObservableGroupManager);
32
33
var conventionalSystems = new List<IConventionalSystemHandler>
34
{
35
manualSystemHandler,
36
basicSystemHandler
37
};
38
39
// The main executor which manages how systems are given information
40
SystemExecutor = new SystemExecutor(conventionalSystems);
41
}
42
43
public abstract void StartApplication();
44
}
Copied!
Then all you need to do is go:
1
public class HelloWorldExampleApplication : EcsRxApplication
2
{
3
public override void StartApplication()
4
{
5
SystemExecutor.AddSystem(new TalkingSystem());
6
7
var defaultCollection = EntityCollectionManager.GetCollection();
8
var entity = defaultCollection.CreateEntity();
9
10
var canTalkComponent = new CanTalkComponent {Message = "Hello world"};
11
entity.AddComponent(canTalkComponent);
12
}
13
}
Copied!
HUZZAH! you are now up and running and you can make your own conventions or design patterns around this.
Last modified 5mo ago