What's new in Entities 1.0

This is a summary of the changes in Entities version 1.0.

For a full list of changes, see the Changelog. For information on how to upgrade to version 1.0, see the Upgrade guide.

Added

  • Aspects, which group different components together into a single C# struct. This helps you to organize your component code and simplify queries in your systems. For more information, see the IAspect API documentation, and the user manual documentation on Aspects.
  • Baking replaces the previous conversion pipeline in Entities. For information on how to use the new system, see the Baker<TAuthoringType> API documentation and the Baking user manual.
  • Enableable components, which you can use to semantically add or remove a component to an entity without effectively changing its archetype. This avoids structural changes, which impact on performance. For more information, see the IEnableableComponent API documentation, and the user manual documentation on enableable components.
  • The Journaling editor window, which provides an in-Editor view of journaling records connected to the various other Entities windows. For more information, see Journaling
  • New authoring-runtime workflow, which affects the Entities Hierarchy and the Inspector, allowing you to change between authoring and runtime representations without having to change your selection context. For more information, see Working with authoring and runtime data.
  • Query<T>, which you use with an idiomatic foreach statement to iterate over entities in ISystem based systems. Entities.ForEach is now deprecated in ISystem systems. For more information, see the information in the upgrade guide.

Updated

  • The way that Transforms work in Entities has been changed to reduce the number of components required to represent an affine transform. For more information, see the Transform API documentation, and the user manual documentation on Transforms.
  • You can now use the Build Settings window to build your project, and don’t need to use Build Configuration assets. For any specialized use cases, you can use the Scriptable Build Pipeline.
  • Settings that were previously in the DOTS menu have moved to the Preferences window. For more information, see the Entities Preferences reference.

Additional resources