dartemis 0.10.0

An Entity System Framework for game development. Based on Artemis.

Changelog

0.10.0

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

0.9.9

Enhancements

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

0.9.8+1

Bugfix

• fix crash when moving components

0.9.8

Enhancements

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

0.9.7

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)

0.9.6

Enhancements

• performance improvement when adding/removing components

0.9.5+3

Bugfix

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

0.9.5+2

Documentation

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

0.9.5+1

Bugfix

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

0.9.5

Enhancements

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

0.9.4

Bugfix

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

0.9.3

Bugfix

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

0.9.2

Bugfix

• handle more than 32 entities with the same components

0.9.1

Bugfix

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

0.9.0

Internal

• updated dependencies to stable versions

0.9.0-nullsafety.0

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

0.8.0 (Dart 2.0+ required)

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

0.7.3

Bugfixes

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

0.7.2

Bugfixes

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

0.7.1

Internal

• upgraded dependencies

0.7.0

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

0.6.0

API Changes

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

0.5.2

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

0.5.1

Internal

• added version constraint for release of Dart

0.5.0

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

0.4.2

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

0.4.1

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

0.4.0

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