QuickMagic VMD-TDA → Virt-A-Mate

VMD Motion Import Guide: Use QuickMagic MoCap in VaM

Generate a VMD-compatible motion from video, choose a safe Virt-A-Mate import route, install a player or converter, load body motion and optional audio, correct scale, floor contact and physics, then save an editable scene or Timeline animation.

Published February 9, 2026 · Updated July 15, 2026 · QuickMagic Editorial Team

QuickMagic VMD to Virt-A-Mate workflow from video capture to plugin import and physics refinement
Direct answer: Export VMD-TDA from a QuickMagic Starter or Professional account, install an authorized VaM VMD workflow, place the motion file in a folder the plugin can access, load a scene with a Person atom, assign the VMD and optional WAV/audio file, press Play, then correct character scale, root height, floor contact and physics. Use a direct VMD player for quick playback, mmd2timeline for editable Timeline JSON, or an offline converter for a generated VaM scene.

Current workflow facts

QuickMagic FreeFBX only on the current plan table
VMD availabilityStarter and Professional
Original articleUses VaM 1.22 legacy screenshots
Commercial playerMMD VMD Player 5.3.5, updated Feb. 2025
Editable optionmmd2timeline 1.4f1
Free legacy optionFreeMMD Alpha or offline converter
Security and licensing note: Do not distribute or depend on an unverified “VaM 1.22 all-in-one bundle.” Install VaM through its authorized channel and obtain plugins from VaM Hub or the plugin author's official page. VaM Hub currently warns that the commercial MMD VMD Player package contains an executable and modifications to base DLL files, so evaluate the package, back up the installation and accept the risk only after reviewing the current resource page.
Comparison of direct VMD playback, VMD to Timeline conversion and offline VMD to VaM scene conversion
The three approaches solve different problems. Select one as the primary animation source to avoid multiple plugins fighting over the same Person controls.

Watch the QuickMagic and VaM VMD workflows

The Easiest Way to Animate in MMD — QuickMagic AI Motion Capture

Shows the video-to-MMD/VMD side of the workflow and the importance of using an MMD-compatible export.

Open video on YouTube

VaM VMDPlayPlugIn — Free MMD/VMD Player Tutorial

Demonstrates the VaM side: installing a VMD player, assigning a character and playing an MMD motion.

Open video on YouTube

Both videos use static YouTube iframes and require no runtime JavaScript. If a browser, region, network or local file viewer blocks embedded playback, use the red direct-link buttons. Every instructional image below is embedded in this HTML file.

Choose the VaM import path before installing anything

PathBest useAdvantagesLimitations and risk
Commercial MMD VMD PlayerFast playback with music, camera and supported facial channelsMature player workflow; current resource version 5.3.5Paid; VaM Hub displays an executable/base-DLL modification warning
FreeMMD AlphaSimple body/finger motion and audio playbackHub-hosted VAR, small and freeLast updated in 2020; explicitly described as alpha
mmd2timelineEditing frames, triggers, playlists and Timeline integrationConverts VMD to JSON that Timeline can editSampling takes time; plugin documents bugs and folder restrictions
mmd_vam_import Python converterOffline conversion into a VaM scene JSONNo live VMD player required; scriptableLegacy tool; requires Python and significant manual physics/proportion tuning

1Generate a VMD-TDA motion in QuickMagic

  1. Record a clear full-body video with the performer and feet visible.
  2. Upload the original file to QuickMagic.
  3. Inspect limb identity, root travel and foot contact before export.
  4. Use 2D Refinement when available to correct visible tracking errors.
  5. Select the VMD or VMD-TDA output shown by the current interface.
  6. Match the desired frame rate and clip duration.
  7. Preserve the original video and untouched VMD source.
Plan requirement: The current QuickMagic pricing page lists VMD for Starter and Professional. The Free plan currently lists FBX only.

2Install VaM and the VMD workflow safely

  1. Use an authorized Virt-A-Mate installation.
  2. Back up the VaM folder before installing plugins that modify base files.
  3. Open the current VaM Hub resource page and read its version, dependencies, update history and warnings.
  4. Prefer a Hub-hosted VAR when a suitable maintained option exists.
  5. For manual script/DLL packages, preserve the exact folder structure documented by the creator.
  6. Restart VaM when the selected package requires it.
  7. Test in a new scene before opening an important production scene.
The original article places files such as MMDPlayer.dll under Custom/Scripts/MMDPlayer. This is a legacy package layout, not a universal installation rule for every VMD plugin. Follow the installed plugin's own documentation.

3Prepare a VaM scene and Person atom

  1. Launch VaM and open a clean scene.
  2. Add or select a Person atom.
  3. Enter Edit Mode.
  4. Reset the character to a neutral or T-pose if the plugin requires it.
  5. Open the Person plugin panel or Scene Plugins panel required by the selected tool.
  6. Disable other animation plugins that control the same body during the initial test.

The original article uses a Scene Plugin workflow. Other plugins, including FreeMMD and mmd2timeline, may be attached to a Person atom instead. Use the location stated by the specific resource.

Legacy VaM 1.22 MMDPlayer.dll loading sequence

These screenshots are preserved from the original QuickMagic article as a compatibility reference. They show an older manual DLL workflow and may not match the current plugin package.

Legacy VaM file selector showing the Custom Scripts MMDPlayer folder
Legacy step: browse to the Custom/Scripts/MMDPlayer folder.
Legacy VaM file selector showing MMDPlayer.dll
Legacy step: select MMDPlayer.dll. Use only a DLL obtained from an authorized source and matching the installed VaM/plugin version.
Legacy VaM Scene Plugins panel with MMDPlayer loaded and Open Custom UI button
A successfully loaded legacy scene plugin exposes an Open Custom UI button.

4Load VMD motion, audio and optional camera data

  1. Open the VMD player's custom UI.
  2. Select the target Person or motion receiver.
  3. Choose Load File or Load Folder.
  4. Select the QuickMagic VMD.
  5. Load a matching WAV/audio file when the workflow needs music synchronization.
  6. Assign camera motion only when the plugin and VMD contain compatible camera data.
  7. Press Play and inspect the complete motion.
Legacy VaM MMD Player interface with Load Folder, Load File, Play, audio, camera and Person Motion controls
Legacy MMD Player UI from the original article. Modern versions can use different buttons or package structure.
File-security rule: Some VaM plugins require the VMD to be inside the VaM directory. mmd2timeline explicitly documents this restriction and suggests a symbolic link only when users understand the operating-system implications.

Alternative: convert QuickMagic VMD to VaM Timeline

mmd2timeline converts VMD into JSON that the VaM Timeline plugin can play and edit. This is usually the better path when you need manual frame edits, triggers or reusable scene animation rather than simple dance playback.

  1. Install the required Timeline and mmd2timeline resources and dependencies.
  2. Add the documented mmd2timeline.PersonAtom.cslist to the Person atom.
  3. Place the VMD inside the allowed VaM directory.
  4. Initialize the Person atom.
  5. Import the VMD.
  6. Run Sample and wait for the fast sampling process to complete.
  7. Export the resulting JSON.
  8. Load the JSON in Timeline and edit keys, triggers or playlists.
The mmd2timeline author documents known bugs in its underlying MMD library. Validate finger, foot, root and interpolation behavior before using the result in a final scene.

Alternative: offline VMD-to-VaM scene conversion

The open-source mmd_vam_import utility converts a VMD file into a VaM scene JSON using Python. It is useful for technical users who prefer a generated scene rather than a live player plugin.

  1. Install Python 3 and the documented Python dependency.
  2. Download the converter script and base scene from its repository.
  3. Set the VMD input path, base-scene path and output-scene path.
  4. Run the conversion script.
  5. Open the generated scene in VaM.
  6. Tune physics, proportions and controls manually.
This is a legacy community utility rather than a current QuickMagic or VaM feature. Review the code before execution and use it only with files you are authorized to process.

Fix scale, feet, jitter and VaM physics

A valid QuickMagic VMD can still look wrong because MMD/TDA motions and VaM characters use different proportions, control systems and physics.

Diagram showing differences between MMD TDA motion and a VaM character in scale, IK and physics
Tune the target character and player settings after import. Do not assume one VMD will fit every VaM body without adjustment.
ProblemLikely causeRecommended adjustment
Feet slideCharacter proportions, root scale or MMD foot IK differMatch body scale, adjust root/motion scale, tune foot controls or edit in Timeline
Character floats or sinksRoot height or floor reference mismatchCorrect position reference, root Y/height and scene floor
Limbs oscillateDrive/hold strength and damping conflict with physicsReduce drive/hold strength or increase damping gradually
Body deforms excessivelySoft-body physics conflicts with fast animationReduce or disable conflicting soft-body physics during diagnosis
Hands/fingers are wrongPlugin lacks channel support or mapping differsUse a plugin supporting finger channels or edit the result separately
Motion timing differs from musicFrame rate, sample rate or audio offset mismatchSet the player/sample rate and apply a measured audio offset

5Save, bake or export the working result

  1. Save the VaM scene as a new JSON rather than overwriting the base scene.
  2. Preserve the original QuickMagic VMD.
  3. Save plugin presets when the plugin supports them.
  4. For Timeline workflows, export the sampled/edited JSON.
  5. Use the player's Bake or export function only when the selected plugin documents it.
  6. Reload the saved scene and verify the dependencies are resolved.
  7. Document plugin versions and required VAR packages for future reuse.
Archive the dependencies. A VaM scene can depend on a specific plugin version, Timeline package, character look, audio file and VMD. Store a dependency list with the project.

Common QuickMagic VMD-to-VaM problems

ProblemLikely causeRecommended fix
VMD option is missing in QuickMagicFree plan or a workflow without VMD entitlementUse a plan/export workflow currently listing VMD and confirm the active export menu.
Plugin does not appearWrong installation path, missing dependency or incompatible package versionFollow the current resource instructions and inspect VaM error logs.
VaM cannot browse to the VMDFile-security restrictionMove the VMD into the documented VaM folder or use the plugin's supported link method.
Motion does not affect the characterNo Person assigned, wrong atom type or another plugin controls the bodyAssign the intended Person and temporarily disable competing animation plugins.
Character starts in a distorted poseReference-pose or proportion mismatchReset to the plugin's required pose and tune character/motion scale.
Audio and motion driftFrame/sample-rate mismatch or offsetUse a consistent rate and set a measured start offset.
Scene works only on one computerMissing VAR, plugin, VMD, audio or absolute pathPackage authorized dependencies and use project-relative paths where supported.
Security warning appearsThe selected resource modifies executable/base filesReview the current VaM Hub warning, back up the installation and choose a lower-risk alternative when appropriate.

Production checklist

  • The source video has clear body visibility and stable tracking.
  • VMD is available on the active QuickMagic plan.
  • The VaM and plugin packages come from authorized sources.
  • The selected plugin version and dependencies are documented.
  • The VMD file is inside an allowed location.
  • Only one primary animation system controls the Person during testing.
  • Character scale, root height and floor contact are validated.
  • Physics settings are tuned for the motion speed.
  • Audio and motion timing are checked.
  • The saved scene is reopened to verify all dependencies.

Frequently asked questions

Can QuickMagic export VMD for Virt-A-Mate?

Yes. The current Starter and Professional plan descriptions list VMD output. Load or convert the resulting VMD with a compatible VaM workflow.

Is VMD available on the Free plan?

The current pricing page lists FBX for Free. VMD is listed for Starter and Professional.

Which VaM VMD workflow should I choose?

Choose a direct player for fast playback, mmd2timeline for editable Timeline JSON, or an offline converter for a generated VaM scene file.

Should I use the VaM 1.22 bundle linked in the original article?

Use an authorized VaM installation and obtain plugins from VaM Hub or the creator's official page. Avoid redistributing or depending on a full-application bundle with unclear source, licensing or executable modifications.

Why does the character move incorrectly?

MMD/TDA and VaM characters can use different proportions, IK assumptions and physics. Adjust scale, root height, drive/hold strength, damping and contacts.

Can VMD include face and camera data?

VMD can contain several MMD data types, but the actual QuickMagic export and selected VaM plugin determine which body, finger, face or camera channels are present and supported.

Why can the plugin not see my VMD?

VaM file-security policies can restrict external paths. Place the file inside the VaM directory or the folder documented by the plugin.

How do I reduce foot sliding and jitter?

Begin with a clean QuickMagic motion, match character proportions, correct root and floor height, tune strength and damping, and edit remaining errors in Timeline or the player's correction tools.

Related QuickMagic guides

QuickMagic export formats
Compare VMD with FBX, BVH, BIP and software-specific presets. QuickMagic beginner guide
Record, configure, refine and export a first motion. Improve motion-capture quality
Reduce source tracking errors before VMD export. Fix common mocap problems
Diagnose foot sliding, jitter, clipping and root drift.

Test one short VMD before building a full VaM scene

Export a 5–10 second QuickMagic motion, validate the selected player or converter, tune the target character and record the working plugin versions before processing a full dance.

Open QuickMagic AI Motion Capture →

Official and primary references