Module bevy::ecs::entity

Entity handling types.

An entity exclusively owns zero or more component instances, all of different types, and can dynamically acquire or lose them over its lifetime.

empty entity: Entity with zero components. pending entity: Entity reserved, but not flushed yet (see Entities::flush docs for reference). reserved entity: same as pending entity. invalid entity: pending entity flushed with invalid (see Entities::flush_as_invalid docs for reference).

See Entity to learn more.

Usage

Operations involving entities and their components are performed either from a system by submitting commands, or from the outside (or from an exclusive system) by directly using World methods:

Operation	Command	Method
Spawn an entity with components	Commands::spawn	World::spawn
Spawn an entity without components	Commands::spawn_empty	World::spawn_empty
Despawn an entity	EntityCommands::despawn	World::despawn
Insert a component, bundle, or tuple of components and bundles to an entity	EntityCommands::insert	EntityMut::insert
Remove a component, bundle, or tuple of components and bundles from an entity	EntityCommands::remove	EntityMut::remove

Structs

• Entities
  A World’s internal metadata store on all of its entities.
• Entity
  Lightweight identifier of an entity.
• EntityLocation
  A location of an entity in an archetype.
• EntityMap
  A mapping from one set of entities to another.
• ReserveEntitiesIterator
  An Iterator returning a sequence of Entity values from Entities::reserve_entities.

Enums

• MapEntitiesError
  The errors that might be returned while using MapEntities::map_entities.

Traits

• MapEntities
  Operation to map all contained Entity fields in a type to new values.