struct

PhysicalAnimationComponent

Blends simulated physics onto an animated skeleton over a bone chain — hit reactions that recover. The named chain root plus (optionally) its descendants are simulated as a powered ragdoll: motors pull the bodies toward the animated pose while gameplay impulses knock them off it, and the physics contribution blends back to animation over recoverTime.

Module
Physics
Header
#include "Physics/Components/PhysicalAnimationComponent.h"
Namespace
Mowo
Reflection
Reflected by MowoHeaderTool

Lifecycle (managed by PhysicalAnimationSystem): - enabled=false → dormant, pure Animator playback - continuous=true → the chain is always physically driven at blendWeight (floppy hair, a limp arm) - continuous=false → the chain rides the animation exactly until an impulse lands; then physics takes over at blendWeight and decays back over recoverTime

Properties

TypeNameDescription
boolenabledAuthored fields. Default true.
FPhysicalAnimationProfileprofile
std::vector<FPhysicalAnimationOverride>profileOverrides
std::stringboneChainRoot
boolincludeChildrenDefault true.
floatblendWeightDefault 1.0f.
boolcontinuousDefault false.
floatrecoverTimeDefault 0.6f.
std::vector<PendingImpulse>pendingImpulses
std::shared_ptr<FPhysicsRagdollState>ragdollRuntime state (NOT serialized, rebuilt each enable cycle).
std::vector<RagdollBodyMapping>mappings
std::vector<uint8_t>boneInChain
boolliveDefault false.
boolchainResolvedDefault false.
floatimpulseWeightDefault 0.0f.

Public functions

ReturnsNameDescription
voidApplyImpulse
voidApplyImpulseAtPoint

Function details

ApplyImpulse

C++
void ApplyImpulse(int32_t boneIndex, const Vec3& impulse)

ApplyImpulseAtPoint

C++
void ApplyImpulseAtPoint(int32_t boneIndex, const Vec3& impulse, const Vec3& worldPoint)
Generated from Physics/Components/PhysicalAnimationComponent.h via physics.json · Nov 4, 2026Version 1.0.0