struct
RetargetComponent
Retargets the animator's clips — authored against sourceSkeleton — onto the entity's own (target) skeleton at runtime. When enabled and a source skeleton is set, the AnimationSystem samples the active clip against the source rig, then replays it onto the target through an FRetargetMap so a character can reuse animation authored for a differently-proportioned rig with matching bone names. map/built are the runtime cache — the map is rebuilt whenever the source or target skeleton changes.
- Module
- Game
- Header
#include "Game/Components/RetargetComponent.h"- Namespace
Mowo- Reflection
- Reflected by MowoHeaderTool
Properties
| Type | Name | Description |
|---|---|---|
bool | enabled | Default true. |
float | heightRatio | Default 0.0f. |
Ref<Skeleton> | sourceSkeleton | |
std::string | retargeterPath | Authored .mretarget asset holding the name map, prefix strips and per-bone translation modes for this SOURCE→TARGET rig pair. Resolved once by the AnimationSystem into options below, so every hydration path (scene load, prefab, spawn) picks it up without the caller knowing the asset exists — the same shape as AnimatorComponent::controllerPath. |
bool | retargeterResolveAttempted | Default false. |
FRetargetOptions | options | Name-remap rules + per-bone translation modes fed to the map build. Loading a retargeter asset overwrites this wholesale, so code that sets it by hand must not also name an asset. After mutating, clear built so the next evaluation rebuilds. |
FRetargetMap | map | |
bool | built | Default false. |
const Skeleton* | builtSource | Default nullptr. |
const Skeleton* | builtTarget | Default nullptr. |
Generated from Game/Components/RetargetComponent.h via game.json · Nov 5, 2026Version 1.0.0