Breaking API Changes #

• entities are no longer simple ints and have been turned into an extension type Entity(int). Methods that previously expected int entity or Iterable<int> entities> now expect Entity entity or Iterable<Entity> entities
• removed named parameters group and passive from World.addSystem, they are now named parameters of the constructor of EntitySystem
• the initialize-method of Managers and EntitySystems now has a parameter for the World and must be called when overriding initialize
• it's no longer possible to add systems or managers after the world has been initialized
• ComponentType has been turned into an extension type, static methods of this class are now instance methods on ComponentManager
• combined the different Aspect-constructors into a single one with optional named parameters for allOf, oneOf and exclude

Enhancements #

• it's now possible to have multiple worlds (e.g. multiple games in the same webpage/app)
  • sharing instances of components/entities/managers/systems between worlds is NOT possible and things will break
• added @visibleForOverriding-annotations to several methods that are only supposed to be called by dartemis

Enhancements #

• new method getTag in TagManager to get the tag of an entity

Bugfix #

• fix crash when moving components

Enhancements #

• new method in World to move a component from one entity to another

Enhancements #

• EntitySystem.checkProcessing() is no longer abstract, returns true
• delta can be directly accessed in systems (BREAKING CHANGE if variable delta already exists in extending system)

Internal #

• use SDK 2.17 (super parameters, constructor tear-offs)

Enhancements #

• performance improvement when adding/removing components

Bugfix #

• componentManager.getComponent couldn't handle accessing components that don't exist for the specific entity

Documentation #

• updated links and minor changes to the example code in README.md

Bugfix #

• componentManager.getComponent couldn't handle accessing components if no high index entities with those components have been created

Enhancements #

• allow direct access to a specific component without use of mappers via world.componentManager.getComponent(int entity, ComponentType componentType)

Bugfix #

• don't update the active entities in a systems if nothing changed
• don't allow multiple instances of the same system or manager

Bugfix #

• process deleted entities after a system finishes in case the system interacts multiple times with the deleted entity

Bugfix #

• handle more than 32 entities with the same components

Bugfix #

• handle more than 32 components when adding systems for components that haven't been used yet

Internal #

• updated dependencies to stable versions

Breaking API Changes #

• removed ComponentTypeManager and moved methods to ComponentType
• getComponents* methods in ComponentManager now return a List instead of a Bag

Enhancements #

• switched to NNBD mode
• added OptionalMapper with a nullable return type for the [] operator

Breaking API Changes #

• removed deprecated code
• replaced Entity with int, methods previously on Entity need to be called on World, with the int value of the entity as the first parameter
• removed world.processEntityChanges, it's now done by default after every system
• Aspect no longer uses static methods, uses named constructors instead (migration: replace Aspect.getAspectF with Aspect.f)
• methods in Aspect no longer return the aspect, use cascading operator to chain calls
• improved type safety for world.getManager and world.getSystem, no longer takes a Type as parameter and uses generic methods instead (e.g. world.getManager<TagManager>() instead of world.getManager(TagManager))
• removed Type parameter in the constructor of Mapper, change code from Mapper<Position>(Position, world) to Mapper<Position>(world)

Enhancements #

• world.destroy() for cleaning up EntitySystems and Managers

Internal #

• existing entities are processed first, addition of new entities is processed last, makes more sense now that the processing is done after every system

Bugfixes #

• adding an entity to a dirty EntityBag could lead to an inconsistency between the bitset and the list of entities

Bugfixes #

• removing an entity multiple times caused it to be added to the entity pool multiple times

Internal #

• upgraded dependencies

Breaking API Changes #

• renamed Poolable to Pooled
• renamed ComponentPoolable to PooledComponent
• removed FastMath and Utils, unrelated to ECS
• removed removeAll from Bag
• time and frame getters have been moved from World to EntitySystem, World has methods instead

API Changes #

• deprecated ComponentMapper use Mapper instead
• deprecated ComponentMapper#get(Entity), use Mapper[Entity] instead
• properties have been added to the World, can be accessed using the [] operator
• Systems can be assigned to a group when adding them to the World, Word.process() can be called for a specific group

Enhancements #

• performance improvement when removing entities

Bugfixes #

• DelayedEntityProcessingSystem keeps running until all current entities have expired

Internal #

• upgraded dependencies

API Changes #

• Bag is Iterable
• removed ReadOnlyBag, when upgrading to 0.6.0 replace every occurence of ReadOnlyBag with Iterable

Enhancements #

• injection works for Managers
• initialize() in the Manager is no longer abstract (same as in EntitySystem)
• World.createEntity got an optional paramter to create an Entity with components
• new function World.createAndAddEntity which adds the Entity to the world after creation

Bugfixes #

• added getter for the World in Manager
• the uniqueId of an Entity was always 0, not very unique

Internal #

• added version constraint for release of Dart

Enhancements #

• more injection, less boilerplate (when using dartemis_mirrors)
  • Instances of ComponentMapper no longer need to be created in the initialize-method of a system, they will be injected
  • Managers and EntitySystems no longer need to be requested from the World in the initialize-method of a system, they will be injected

Bugfixes #

• EntityManager.isEnabled() no longer fails if the bag of disabled entities is smaller than the id of the checked entity

Enhancements #

• added getters for current time and frame to World

Bugfixes #

• World.deleteAllEntites() did not work if there was already a deleted entity
• writing to the Bag by index doesn't make it smaller anymore

API Changes #

• swapped parameters of Tagmanager.register
• replaced ImmutableBag with ReadOnlyBag, added getter for ReadOnlyBag to Bag
• changed FreeComponents to ObjectPool
• old Component has changed, there are two different kinds of components now:
  • instances of classes extending ComponentPoolable will be added to the ObjectPool when they are removed from an Entity (preventing garbage collection and allowing reuse)
  • instances of classes extending Component will not be added to the ObjectPool when they are removed from an Entity (allowing garbage collection)

Enhancements #

• added function deleteAllEntities to World
• IntervalEntitySystem has a getter for the delta since the systm was processed last
• updated to work with Dart M4

Bugfixes #

• GroupManager.isInGroup works if entity is in no group