Tips: Use Custom Motion in VMagicMirror

This feature is available in v1.6.0 and later.

Following steps enable to use non-built-in motions in VMagicMirror.

  1. On Unity Editor, export motion files available on VMagicMirror.
  2. Put exported motion file to specific folder.
  3. Select the motion on Word to Motion feature.


VRM Animation file is supported from VMagicMirror v3.4.0, and it has different setup steps and different restrictions.

See detail at Use VRM Animation page.


  • You need to export motion in Unity Editor.
  • You do NOT need the knowledge about Unity C# script.
  • It is good to know about Animation Clip, but

Available Formats and Limitations


  • You can export motion which is recognized as Humanoid Animation, in Unity 2019.4.x.
    • Pure AnimationClip created in Unity 2019.4 is available.
    • Motions in fbx file for Humanoid model will also be available, though there are exceptions.


  • Root pose and lower body motion is not played.
    • This is because VMagicMirror originally assumes upper body only motion.
  • IK based hand motion is not played, though exported in the data.
    • Hand IK will be supported in future updates.
  • Cannot play loop animation.

1. Export Motion

In Unity 2019.4.14f1, create a new project or open existing one.

Then visit VMagicMirror_MotioExporterのReleases to get latest version .unitypackage.

Import the .unitypackage, and open scene Assets/Baku/VMagicMirror_MotionExporter/Scenes/MotionExporter.

In the scene, select Exporter object and see Motion Exporter component. Set the AnimationClip you want to export to Export Target.

Then press Export button to save the file in StreamingAssets folder. The file addition might be not reflected, and in this case please check file in file explorer, or restart Unity.

The file name is like (AnimationClip name).vmm_motion. As long as you maintain the file extension you can change the file name.


At this step you can check the file export is actually successful, by following step.

  1. Import UniVRM.
  2. Import a VRM model and put on MotionExporter scene.
  3. Select MotionTestPlayer and setup MotionTestPlay component.
    • FileName: Motion file name in StreamingAssets folder.
    • Target: VRM model
    • OnlyUpperBody: On (*on by default)
  4. Play the scene.

2. Put the Exported Motion File

Move exported motion file (.vmm_motion) into VMagicMirror’s folder.

Check VMagicMirror’s version to place files correctly.

If the folder does not exist, please create new one.

3. Word to Motion Setup

Start VMagicMirror and open Word to Motion item edit window. If this step is unclear, see Expression page.

Choose Custom Motion in motion option, then select motion.

After the setup, the motion will be available almost same as built-in motion.


If you do not see the motion selecion, then exported data format might incorrect.

In this case see 1. Export Motion and try the check process written in tips.