FMassCommandAddFragmentInstances

Navigation

API > API/Runtime > API/Runtime/MassEntity

Adds fragments with initial values to entities. Each entity receives typed fragment data. Tags (FMassTag, FMassSparseTag) are also accepted — they participate in the composition change but are excluded from the value payload (tags have zero-size storage). Uses PushCommand for cross-chunk batching. Sparse fragments are supported (handled internally). All entities are accumulated in a single flat batch and dispatched in one BatchAddFragmentInstancesForEntities call.

When to use: when you need to add fragments AND set their initial values in one operation, optionally adding tags in the same entity move. For composition-only changes (no values), prefer FMassCommandAddElements. For adding shared fragment values in the same move, use FMassCommandAddFragmentInstancesWithSharedFragments.

Example: // Add fragments with values + tags in a single entity move: Context.Defer().PushCommand(EntityHandle, FMyFragmentA(42), FMyTag());

Supported types: FMassFragment + FMassTag (including sparse). Tag instances are accepted by Add() for uniform syntax but their values are ignored. Breakpoint support: Yes — CheckFragmentAddBreakpoints called at PushCommand time.

Syntax

template<typename... TOthers>  
struct FMassCommandAddFragmentInstances : public FMassBatchedEntityCommand  
Copy full snippet

template<typename... TOthers> struct FMassCommandAddFragmentInstances : public FMassBatchedEntityCommand

Inheritance Hierarchy

• FMassBatchedCommand → FMassBatchedEntityCommand → FMassCommandAddFragmentInstances

Derived Classes

• FMassCommandAddFragmentInstancesAndResaveIAPersistence
• FMassCommandBuildEntity

Constructors

Typedefs

Functions

Public

Protected Virtual

Overridden from FMassBatchedCommand