FMassCommandRemoveElements

Navigation

API > API/Runtime > API/Runtime/MassEntity

Removes any mix of element types from entities. This is the preferred command for element removal. Types are template parameters — uses PushCommand for efficient cross-chunk batching (one Run() for all entities across all chunks that push into this command). Performs a single entity move for all non-sparse types.

When to use: whenever you need to remove fragments, tags, shared fragments, and/or sparse elements from entities and the types are known at compile time. Replaces FMassCommandRemoveFragments and FMassCommandRemoveTags.

Example: // All entities in chunk: Context.Defer().PushCommand>(Context.GetEntities()); // Single entity: Context.Defer().PushCommand>(EntityHandle); // Via convenience: Context.Defer().RemoveElements(Context.GetEntities());

Supported types: all FMassElement subtypes (fragments, tags, shared, const shared, sparse). Breakpoint support: Yes — CheckFragmentRemoveBreakpoints called per entity at PushCommand time. Entity moves: 1 move for all non-sparse types combined. Sparse removal is in-place (no move).

Syntax

template<typename... TTypes>  
struct FMassCommandRemoveElements : public FMassBatchedEntityCommand  
Copy full snippet

template<typename... TTypes> struct FMassCommandRemoveElements : public FMassBatchedEntityCommand

Inheritance Hierarchy

• FMassBatchedCommand → FMassBatchedEntityCommand → FMassCommandRemoveElements

Constructors

Typedefs

Functions

Public

Protected Virtual

Overridden from FMassBatchedCommand