Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

AnimMirrorTool

UE5 editor plugin that bakes mirrored animations as separate assets using Mirror Data Tables.

If your game uses root motion montages, and you need mirrored variants, runtime mirroring won't work. This tool bakes them offline instead.

Features

  • Mirrors bone transforms using the exact FAnimationRuntime::MirrorPose math, applied per-frame via IAnimationDataController
  • Remaps notifies, curves, and sync markers per your Mirror Data Table mappings
  • Notify property remapping - swaps values inside notify properties (e.g. socket names, gameplay tags) via FProperty reflection
  • Montage support - duplicates montages and swaps internal sequence references
  • Two workflows:
    • Right-click any AnimSequence/AnimMontage → "Mirror Animation"
    • Batch export via Animation Mirror Profile editor (retargeter-like UX)

Install

Copy this folder into your project's Plugins/ directory. No other dependencies, just standard UE5 engine modules.

Tested on UE 5.6. Should work on 5.3+ (uses IAnimationDataController API).

Usage

Quick (single animation)

  1. Right-click an AnimSequence or AnimMontage in Content Browser
  2. Mirror Animation
  3. Pick your Mirror Data Table, set a name suffix
  4. Click Mirror

Batch (profile editor)

  1. Content Browser → Add → Animation → Animation Mirror Profile
  2. Double-click to open the editor
  3. Set your Skeleton and Mirror Data Table
  4. Add animations to the Entries array
  5. Optionally add Notify Remap Rules (for project-specific notify properties)
  6. Click Export All in the toolbar

Notify property remapping

Standard Mirror Data Tables only remap notify names. This tool also remaps property values inside notifies:

Notify Class:    UAnimNotify_ComboHitWindow
Property:        WeaponTraceTag
Value Mappings:  "Trace.Weapon.Right" → "Trace.Weapon.Left"

Supports FName, FString, and FGameplayTag property types.

Architecture

AnimMirrorTool (Editor-only module)
├── UAnimMirrorProfile       Config asset (skeleton, mirror table, entries, remap rules)
├── UAnimMirrorBaker         Static baker (MirrorAnimSequence, MirrorAnimMontage, BatchMirror)
├── FAnimMirrorProfileEditor Custom asset editor (details + mapping panel + toolbar)
├── SAnimMirrorDialog        Quick-mirror modal dialog
└── ContentBrowserExtension  Right-click menu integration

License

MIT

About

UE5 editor plugin for baking mirrored animation assets.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages