class

FMotionMatcher

Playback head over the database: advances the current clip, and every searchInterval seconds re-searches. It only switches when the best candidate beats simply CONTINUING the current animation by switchBias — without that margin the search flips between near-identical frames every interval and the character jitters.

Module
Animation
Header
#include "Animation/MotionMatching.h"
Namespace
Mowo

Properties

TypeNameDescription
FMotionSearchFilterfilterRestricts every search to frames carrying all required tags and none of the excluded ones; continuing the current frame is still allowed.
floatsearchIntervalDefault 0.1f.
floatswitchBiasDefault 0.5f.
floatplayRateDefault 1.0f.

Public functions

ReturnsNameDescription
voidSetDatabaseSwapping to another database (a chooser picking the crouch set over the stand set) keeps the playhead's clip and time and forces a search in the new set on the next Update: the old frame index means nothing there.
const Ref<FMotionMatchingDatabase>&Database
voidReset
FMotionMatchResultUpdate
int32_tCurrentFrame
int32_tClipIndex
floatClipTime
boolIsMirrored
uint64_tSearchCount
uint64_tSwitchCount

Function details

SetDatabase

C++
void SetDatabase(const Ref<FMotionMatchingDatabase>& database)

Swapping to another database (a chooser picking the crouch set over the stand set) keeps the playhead's clip and time and forces a search in the new set on the next Update: the old frame index means nothing there.

Database

C++
const Ref<FMotionMatchingDatabase>& Database() const

Reset

C++
void Reset(int32_t frame = 0)

Update

C++
FMotionMatchResult Update(float dt, FMotionQueryBuilder& query)

CurrentFrame

C++
int32_t CurrentFrame() const

ClipIndex

C++
int32_t ClipIndex() const

ClipTime

C++
float ClipTime() const

IsMirrored

C++
bool IsMirrored() const

SearchCount

C++
uint64_t SearchCount() const

SwitchCount

C++
uint64_t SwitchCount() const
Generated from Animation/MotionMatching.h via animation.json · Oct 26, 2026Version 1.0.0