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
| Type | Name | Description |
|---|---|---|
bool | enabled | Authored fields. Default true. |
FPhysicalAnimationProfile | profile | |
std::vector<FPhysicalAnimationOverride> | profileOverrides | |
std::string | boneChainRoot | |
bool | includeChildren | Default true. |
float | blendWeight | Default 1.0f. |
bool | continuous | Default false. |
float | recoverTime | Default 0.6f. |
std::vector<PendingImpulse> | pendingImpulses | |
std::shared_ptr<FPhysicsRagdollState> | ragdoll | Runtime state (NOT serialized, rebuilt each enable cycle). |
std::vector<RagdollBodyMapping> | mappings | |
std::vector<uint8_t> | boneInChain | |
bool | live | Default false. |
bool | chainResolved | Default false. |
float | impulseWeight | Default 0.0f. |
Public functions
| Returns | Name | Description |
|---|---|---|
void | ApplyImpulse | |
void | ApplyImpulseAtPoint |
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