struct WeaponComponent { public int Ammo; public string GunName; }

// NewEntity() используется для создания новых сущностей в контексте мира. EcsEntity entity = _world.NewEntity (); // Get() возвращает существующий на сущности компонент. Если компонент не существовал - он будет добавлен автоматически. // Следует обратить внимание на "ref" - компоненты должны обрабатываться по ссылке. ref Component1 c1 = ref entity.Get<Component1> (); ref Component2 c2 = ref entity.Get<Component2> (); // Del() удаляет компонент с сущности. Если это был последний компонент - сущность будет удалена автоматически. Если компонент не существовал - ошибки не будет. entity.Del<Component2> (); // Replace() выполняет замену компонента новым экземпляром. Если старый компонент не существовал - новый будет добавлен без ошибки. WeaponComponent weapon = new WeaponComponent () { Ammo = 10, GunName = "Handgun" }; entity.Replace (weapon); // Replace() позволяет выполнять "чейнинг" создания компонентов: EcsEntity entity2 = world.NewEntity (); entity2.Replace (new Component1 { Id = 10 }).Replace (new Component2 { Name = "Username" }); // Любая сущность может быть скопирована вместе с компонентами: EcsEntity entity2Copy = entity2.Copy (); // Любая сущность может "передать" свои компоненты другой сущности (сама будет уничтожена): var newEntity = world.NewEntity (); entity2Copy.MoveTo (newEntity); // все компоненты с "entity2Copy" переместятся на "newEntity", а "entity2Copy" будет удалена. // Любая сущность может быть удалена, при этом сначала все компоненты будут автоматически удалены и только потом энтити будет считаться уничтоженной. entity.Destroy ();

class UserSystem : IEcsPreInitSystem, IEcsInitSystem, IEcsRunSystem, IEcsDestroySystem, IEcsPostDestroySystem { public void PreInit () { // Будет вызван один раз в момент работы EcsSystems.Init() и до срабатывания IEcsInitSystem.Init(). } public void Init () { // Будет вызван один раз в момент работы EcsSystems.Init() и после срабатывания IEcsPreInitSystem.PreInit(). } public void Run () { // Будет вызван один раз в момент работы EcsSystems.Run(). } public void Destroy () { // Будет вызван один раз в момент работы EcsSystems.Destroy() и до срабатывания IEcsPostDestroySystem.PostDestroy(). } public void PostDestroy () { // Будет вызван один раз в момент работы EcsSystems.Destroy() и после срабатывания IEcsDestroySystem.Destroy(). } }

class HealthSystem : IEcsSystem { // Поля с авто-инъекцией. EcsWorld _world; EcsFilter<WeaponComponent> _weaponFilter; }

class SharedData { public string PrefabsPath; } ... SharedData sharedData = new SharedData { PrefabsPath = "Items/{0}" }; EcsSystems systems = new EcsSystems (world); systems .Add (new TestSystem1 ()) .Inject (sharedData) .Init ();

class TestSystem1 : IEcsInitSystem { // Поле с авто-инъекцией. SharedData _sharedData; public void Init() { var prefabPath = string.Format (_sharedData.Prefabspath, 123); // prefabPath = "Items/123" к этому моменту. } }

class WeaponSystem : IEcsInitSystem, IEcsRunSystem { // Поля с авто-инъекцией. EcsWorld _world; // Мы хотим получить все сущности с компонентом "WeaponComponent" // и без компонента "HealthComponent". EcsFilter<WeaponComponent>.Exclude<HealthComponent> _filter; public void Init () { _world.NewEntity ().Get<WeaponComponent> (); } public void Run () { foreach (int i in _filter) { // Сущность, которая точно содержит компонент "WeaponComponent". ref EcsEntity entity = ref _filter.GetEntity (i); // Get1() позволяет получить доступ по ссылке на компонент, // указанный первым в списке ограничений фильтра ("WeaponComponent"). ref WeaponComponent weapon = ref _filter.Get1 (i); weapon.Ammo = System.Math.Max (0, weapon.Ammo - 1); } } }

struct Component1 { } struct Component2 : IEcsIgnoreInFilter { } class TestSystem : IEcsRunSystem { EcsFilter<Component1, Component2> _filter; public void Run () { foreach (var i in _filter) { // Мы можем получить компонент "Component1". ref var component1 = ref _filter.Get1 (i); // Мы не можем получить "Component2" - кеш внутри фильтра не существует и будет выкинуто исключение. ref var component2 = ref _filter.Get2 (i); } } }

class Startup : MonoBehaviour { EcsWorld _world; EcsSystems _systems; void Start () { // Создаем окружение, подключаем системы. _world = new EcsWorld (); _systems = new EcsSystems (_world) .Add (new WeaponSystem ()); _systems.Init (); } void Update () { // Выполняем все подключенные системы. _systems.Run (); } void OnDestroy () { // Уничтожаем подключенные системы. _systems.Destroy (); // Очищаем окружение. _world.Destroy (); } }

// Инициализация. EcsSystems nestedSystems = new EcsSystems (_world).Add (new NestedSystem ()); // Нельзя вызывать nestedSystems.Init() здесь, // "rootSystems" выполнит этот вызов автоматически. EcsSystems rootSystems = new EcsSystems (_world).Add (nestedSystems); rootSystems.Init (); // В цикле обновления нельзя вызывать nestedSystems.Run(), // "rootSystems" выполнит этот вызов автоматически. rootSystems.Run (); // Очистка. // Нельзя вызывать nestedSystems.Destroy() здесь, // "rootSystems" выполнит этот вызов автоматически. rootSystems.Destroy ();

class TestSystem : IEcsRunSystem { public void Run () { } } EcsSystems systems = new EcsSystems (_world); systems.Add (new TestSystem (), "my special system"); systems.Init (); var idx = systems.GetNamedRunSystem ("my special system"); // "state" будет иметь значение "true", все системы включены по умолчанию. var state = systems.GetRunSystemState (idx); // Выключаем систему по ее индексу. systems.SetRunSystemState (idx, false);

using Leopotam.Ecs; class EcsStartup { EcsWorld _world; EcsSystems _systems; // Инициализация окружения. void Init () { _world = new EcsWorld (); _systems = new EcsSystems (_world); _systems // Системы с основной логикой должны // быть зарегистрированы здесь, порядок важен: // .Add (new TestSystem1 ()) // .Add (new TestSystem2 ()) // OneFrame-компоненты должны быть зарегистрированы // в общем списке систем, порядок важен: // .OneFrame<TestComponent1> () // .OneFrame<TestComponent2> () // Инъекция должна быть произведена здесь, // порядок не важен: // .Inject (new CameraService ()) // .Inject (new NavMeshSupport ()) .Init (); } // Метод должен быть вызван из // основного update-цикла движка. void UpdateLoop () { _systems?.Run (); } // Очистка. void Destroy () { if (_systems != null) { _systems.Destroy (); _systems = null; _world.Destroy (); _world = null; } } }

EcsSystems _update; EcsSystems _fixedUpdate; void Start () { var world = new EcsWorld (); _update = new EcsSystems (world).Add (new UpdateSystem ()); _update.Init (); _fixedUpdate = new EcsSystems (world).Add (new FixedUpdateSystem ()); _fixedUpdate.Init (); } void Update () { _update.Run (); } void FixedUpdate () { _fixedUpdate.Run (); }

// Это поле будет обработано инъекцией. EcsFilter<C1> _filter1; // Это поле будет проигнорировано инъекцией. [EcsIgnoreInject] EcsFilter<C2> _filter2;

struct MyComponent : IEcsAutoReset<MyComponent> { public int Id; public object LinkToAnotherComponent; public void AutoReset (ref MyComponent c) { c.Id = 2; c.LinkToAnotherComponent = null; } }

struct MyOneFrameComponent { } EcsSystems _update; void Start () { var world = new EcsWorld (); _update = new EcsSystems (world); _update .Add (new CalculateSystem ()) // Все "MyOneFrameComponent" компоненты будут // удалены здесь. .OneFrame<MyOneFrameComponent> () // Здесь можно быть уверенным, что ни один // "MyOneFrameComponent" не существует. .Add (new UpdateSystem ()) .Init (); } void Update () { _update.Run (); }

var config = new EcsWorldConfig () { // Размер по умолчанию для World.Entities. WorldEntitiesCacheSize = 1024, // Размер по умолчанию для World.Filters. WorldFiltersCacheSize = 128, // Размер по умолчанию для World.ComponentPools. WorldComponentPoolsCacheSize = 512, // Размер по умолчанию для Entity.Components (до удвоения). EntityComponentsCacheSize = 8, // Размер по умолчанию для Filter.Entities. FilterEntitiesCacheSize = 256, }; var world = new EcsWorld(config);

class CustomListener: IEcsFilterListener { public void OnEntityAdded (in EcsEntity entity) { // Сущность добавлена в фильтр. } public void OnEntityRemoved (in EcsEntity entity) { // Сущность удалена из фильтра. } } class MySystem : IEcsInitSystem, IEcsDestroySystem { readonly EcsFilter<Component1> _filter = null; readonly CustomListener _listener = new CustomListener (); public void Init () { // Подписка слушателя на события фильтра. _filter.AddListener (_listener); } public void Destroy () { // Отписка слушателя от событий фильтра. _filter.RemoveListener (_listener); } }