In this lesson, you will learn how to programmatically restructure your actor’s component hierarchy at runtime to create dynamic relationships between objects.
Understanding Parent-Child Transforms
In Unreal Engine, every Scene Component exists within a hierarchy. When you attach a "child" component to a "parent" component, the child inherits the parent's transformation—meaning if the parent moves, rotates, or scales, the child follows suit automatically. While you often set these hierarchies in the Blueprint editor, complex character rigs (like a character picking up a sword or changing equipped armor) require you to modify these relationships dynamically via code.
Programmatic Attachment
To change a component's parent at runtime, we use the SetupAttachment function (typically in a constructor) or the AttachToComponent function during gameplay.
Imagine a character picking up an item. To make that item move with the character’s hand, you would attach the item's StaticMeshComponent to the character’s SkeletalMeshComponent at a specific socket:
// Assuming 'EquippedItem' is a SceneComponent and 'CharacterMesh' is a SkeletalMeshComponent
FAttachmentTransformRules AttachmentRules(EAttachmentRule::SnapToTarget, true);
EquippedItem->AttachToComponent(CharacterMesh, AttachmentRules, FName("HandSocketName"));
Detaching Components
When a player drops an item or releases an object, you must break that bond. Detaching removes the inheritance, causing the component to exist independently in the world space again. You use the DetachFromComponent function:
FDetachmentTransformRules DetachmentRules(EDetachmentRule::KeepWorld, true);
EquippedItem->DetachFromComponent(DetachmentRules);
By toggling these attachments, you create "dynamic rigs." This is the foundation for complex interactions, such as mounting a turret to a vehicle or swapping out weapon attachments on a character model. When managing these hierarchies, always ensure your AttachmentTransformRules match your gameplay intent—usually, you will want to "Snap" to the target location to prevent offset glitches during the transition.
Key Takeaway: You manage complex character rigs by programmatically modifying parent-child relationships, allowing child components to inherit transforms from parents only when the gameplay logic dictates the connection.