FMassCommandAddElementList

Navigation

API > API/Runtime > API/Runtime/MassEntity

Adds any mix of non-shared element types to entities at runtime. Element types are provided as UScriptStruct* at construction time. Requires PushUniqueCommand — each call creates a separate command instance (no cross-call batching, but entities batch within a single instance via Add()). Performs a single entity move for all non-sparse types + in-place sparse addition.

When to use: when element types are only known at runtime and you need to add multiple types at once. Prefer FMassCommandAddElements when types are known at compile time (cross-chunk batching).

Example: const UScriptStruct* Types[] = { FMyFragment::StaticStruct(), FMyTag::StaticStruct() }; // Single entity: FMassCommandAddElementList& Cmd = Context.Defer().PushUniqueCommand(Types); Cmd.Add(EntityHandle); // All entities in chunk via convenience: Context.Defer().AddElements(Context.GetEntities(), Types);

Supported types: FMassFragment, FMassTag, FMassSparseFragment, FMassSparseTag. Rejected types: shared/const shared and chunk fragments are rejected at runtime by BatchChangeCompositionForEntities (no compile-time check). Breakpoint support: No (runtime types).

Syntax

struct FMassCommandAddElementList : public FMassBatchedEntityCommand  
Copy full snippet

struct FMassCommandAddElementList : public FMassBatchedEntityCommand

Inheritance Hierarchy

• FMassBatchedCommand → FMassBatchedEntityCommand → FMassCommandAddElementList

Constructors

Typedefs

Functions

Public

Protected Virtual

Overridden from FMassBatchedCommand