Motion Matching

Read a Pose Search Schema (skeletons, channels) or Database (settings, entries)

A schema: sample rate, cardinality, skeletons (skeleton, mirror data table, role) and channels by index with their fields. A database: its settings (Schema, cost biases, tags, search mode...) and entries by index with asset, kind, enabled, mirror option, sampling range and whether the asset's skeleton fits the schema.

cfa get_pose_search_asset /Game/MM/PSS_Locomotion
cfa get_pose_search_asset /Game/MM/PSD_Locomotion --filter Jog

Add a feature channel to a Pose Search Schema (Pose, Trajectory, Velocity...), or Epic's default pair

--type is a channel class from this engine's reflection: Pose, Trajectory, Velocity, Position, Heading, Phase, Curve, Group, Padding... (an unknown name lists the real ones), or default for the Trajectory + Pose pair the editor puts in a new schema. --properties sets the channel's fields by reflection, e.g. {"Weight":2}. Undoable.

cfa add_pose_search_channel --schema-path /Game/MM/PSS_Locomotion --type default
cfa add_pose_search_channel --schema-path /Game/MM/PSS_Locomotion --type Velocity --properties '{"Bone":{"BoneName":"hand_r"},"Weight":0.5}'

Change a Pose Search Schema channel's fields by index (Weight, SampledBones, Samples...)

cfa set_pose_search_channel --schema-path /Game/MM/PSS_Locomotion --index 0 --properties '{"Weight":5}'

Remove a channel from a Pose Search Schema by index

cfa remove_pose_search_channel --schema-path /Game/MM/PSS_Locomotion --index 2

Add or update a Pose Search Schema skeleton by role, with its Mirror Data Table

Plain animations use the default role (leave --role out). Mirrored entries need a Mirror Data Table on every schema skeleton, or the index build fails. --mirror-data-table none clears it.

cfa set_pose_search_skeleton --schema-path /Game/MM/PSS_Locomotion --skeleton /Game/Characters/Mannequins/Meshes/SK_Mannequin --mirror-data-table /Game/MM/MDT_Mannequin

Add animations to a Pose Search Database (sequences, blend spaces, composites, montages)

Done the way the database editor adds them (Modify, add, PostEditChange), so it is undoable. --properties sets entry fields on each added entry by reflection: bEnabled, MirrorOption (UnmirroredOnly, MirroredOnly, UnmirroredAndMirrored), SamplingRange ({"Min":0,"Max":0} is the whole asset), and on 5.7+ the blend space sampling fields. An asset already in the database is skipped and named.

cfa add_pose_search_animations --database-path /Game/MM/PSD_Locomotion --assets /Game/Anims/MF_Jog_Fwd,/Game/Anims/MF_Jog_Bwd --properties '{"MirrorOption":"UnmirroredAndMirrored"}'

Change one Pose Search Database entry by index or asset (enabled, mirror option, sampling range...)

cfa set_pose_search_animation --database-path /Game/MM/PSD_Locomotion --asset /Game/Anims/MF_Jog_Fwd --properties '{"bEnabled":false}'

Remove Pose Search Database entries by asset or index

cfa remove_pose_search_animations --database-path /Game/MM/PSD_Locomotion --assets /Game/Anims/MF_Jog_Fwd

Build a Pose Search Database's search index and wait; returns the engine's own errors and warnings

Uses the same request the cooker makes, then waits. A failed build is an error whose text is the engine's LogPoseSearch message (for example a schema with no channels or a mirrored entry with no Mirror Data Table).

cfa build_pose_search_index --database-path /Game/MM/PSD_Locomotion

Verdict for a Pose Search Database: schema, channels, skeletons, mirror tables, assets, then the index build

Returns verdict = pass | pass_with_warnings | fail plus findings. Each rule is one the index build applies. Errors: no_schema, schema_no_channels, schema_no_skeleton, negative_channel_weight, mirror_table_no_skeleton, mirror_table_missing (a mirrored entry with a schema skeleton that has no Mirror Data Table), asset_no_skeleton, index_build_failed (the engine's own message). Warnings: entry_no_asset, skeleton_incompatible (the engine leaves the asset out), blend_space_sync_phases, no_enabled_entries, index_build_unfinished. --build-index=false skips the build.

cfa validate_pose_search_database /Game/MM/PSD_Locomotion