PMX from MMD to VRChat: the path and the traps
An MMD model is a .pmx with a folder of textures, Japanese bone names, a few hundred morphs and a physics setup of its own. VRChat wants a Unity humanoid in an FBX with a handful of shaders and a triangle budget. This page lays out the path and the four places it usually breaks.
Written against Blender 4.2 to 4.5 with MMD Tools 4.x, Unity 2022.3 with the VRChat SDK 3 through the Creator Companion, and VRChat's performance table as published on 10 November 2026.
Read the licence before anything else
MMD models have no common licence. Each one ships with a readme, and that readme, together with the character owner's terms, decides what you may do: many forbid redistribution, commercial use and use outside MMD, and some name VRChat specifically as forbidden. Models of characters from games or Vocaloid fall under the character owner's terms on top (Crypton's characters under the Piapro Character License, for instance). VRChat's own guide for a first avatar opens with the same sentence: make sure you have a licence to use the model in VRChat.
A conversion you are not allowed to make is not a technical problem, and no tool on this page or elsewhere changes that. If the readme is in Japanese, translate it; the words to look for are 改変 (modification), 再配布 (redistribution), 商用 (commercial) and VRChat itself.
The pipeline
Four programs, in this order.
- Blender with MMD Tools. Install the MMD Tools extension (Edit → Preferences → Get Extensions; Blender 4.2 and later, the maintained fork lives at github.com/MMD-Blender). File → Import → MikuMikuDance Model, pick the .pmx; keep the texture folder next to it. In the import options, Rename Bones turns the 左/右 naming into Blender's .L/.R suffixes, which makes the rig easier to work with; Unity's humanoid mapping does not require them.
- Clean the rig in Blender. MMD rigs carry bones VRChat has no use for: the IK chains, センター and グルーブ above the hips, the physics rigid bodies and joints. Remove the IK targets and the physics objects, keep every bone that carries weights, and repair the parenting so that Hips is the ancestor of every mapped bone, the lower arm is the first child of the upper arm and the hand the first child of the lower arm (the same for the legs); that is what VRChat's rig requirements ask for. MMD Tools' sidebar has Translate for the remaining Japanese names.
- Export FBX. File → Export → FBX, armature and meshes only, with Path Mode set to Copy and Embed Textures on, so the images travel inside the FBX. Or skip the Blender export: the PMX to FBX converter writes a binary FBX from the .pmx with the bone names kept, the vertex morphs as shape keys and the textures embedded, if your edits can wait for Unity.
- Unity through the Creator Companion. Create an Avatars project, import the FBX, set the model's Rig → Animation Type to Humanoid, open Configure and check that hips, spine, chest, neck, head, both arms, both legs, hands and feet are mapped (VRChat requires neck and chest even though Unity treats them as optional). Add the VRC Avatar Descriptor, set the view position between the eyes, pick the visemes from the morphs, then Build & Publish.
The performance wall
VRChat ranks every avatar from Excellent to Very Poor and lets each player hide avatars below a rank. On PC the triangle limits are 32 000 for Excellent and 70 000 for Good; above 70 000 the avatar is Very Poor. PC players see Very Poor avatars by default and may raise the bar; on Quest and Android the default minimum is Medium, so a Poor or Very Poor avatar is hidden for most of those players. MMD models are routinely far over every one of these numbers, in triangles, material slots and bones. The Quest bars are far lower still: 7 500 triangles for Excellent, 20 000 at the edge of Poor, four material slots at most, and only the shaders the SDK ships; a Quest version is a separate build and upload from the PC one.
So the work is reduction, not conversion: decimate the mesh (the mesh decimator keeps the skin weights and shape keys while it cuts triangles), merge materials into an atlas, drop the bones that carry no weight. None of these is a hard upload limit on PC; they decide who renders the avatar.
| Measure | PC limit for Good · Quest limit for Poor |
|---|---|
| Triangles | 70 000 · 20 000 |
| Material slots | 8 · 4 |
| Bones | 150 · 150 |
| Skinned meshes | 2 · 2 |
| Texture memory | 75 MB · 40 MB |
Materials and morphs
MMD materials are a toon lookup with a sphere map and an edge line; Unity's Standard shader cannot show that, and the model turns flat and grey. On PC, rebuild them in a toon shader made for VRChat, lilToon or Poiyomi, assign the base texture and the toon ramp, and set the outline. On Quest you have no choice: only the VRChat Mobile shaders the SDK provides are allowed, so paint the shading into the texture.
MMD morphs come through as shape keys under their Japanese names. VRChat's Viseme Blend Shapes mode lists fifteen mouth shapes; an MMD model has the five vowels (あ, い, う, え, お), so map each viseme to the nearest vowel in the Avatar Descriptor, or choose the Jaw Flap mode and skip the mapping. Blinking takes まばたき under Eyelids, and eye movement takes the eye bones.
The VRM shortcut for every other app
Among the VTubing and avatar apps, VRChat is the one that wants a Unity build. VSeeFace, Warudo, VNyan, VMagicMirror and the browser viewers all read VRM, and a VRM needs no Unity. The MMD to VRM converter takes the .pmx with its texture folder zipped, maps the Japanese bones onto the VRM humanoid (センター becomes the hips, 下半身 is left without a role), keeps the morphs as expressions and writes a VRM 0.x, the version VSeeFace reads. The licence check in the first section applies here just the same.
Questions
- Can I upload the PMX to VRChat directly?
- No. An avatar is built in Unity with the VRChat SDK; this guide feeds it a humanoid FBX. The PMX has to pass through Blender (or the PMX to FBX converter) and Unity.
- Why does Unity say the rig is not humanoid?
- Usually an MMD bone in the wrong place: the IK targets, センター above the hips, or a twist bone as the first child of an arm. Fix the chain in Blender so that Hips is the ancestor of every mapped bone and each limb bone's first child is the next limb bone.
- Why is my avatar invisible to everyone?
- Its rank is below what those players show. On PC the default shows everything, so a player raised the bar; on Quest the default hides Poor and Very Poor, which means more than 15 000 triangles or more than two material slots. Decimate and merge, then check the rank in the SDK's build window before you upload.
- Will the physics come along?
- Not as they were. MMD rigid bodies and joints have no Unity equivalent in the SDK; rebuild hair and skirt movement with PhysBones on the bones that carried them.
- Is the VRM route the same for VRChat?
- VRChat does not load .vrm files. Some community tools import a VRM into Unity and build from there, but the triangle, material and shader limits are the same, so the reduction work does not go away.
Not going to VRChat after all?
Zip the .pmx with its textures, drop it, and get a VRM for VSeeFace, Warudo or VNyan: bones mapped, morphs kept, preview before download. Free, no account, the files are deleted after 3 days.
Open the MMD to VRM converterA .pmx or .pmd model with its textures as a VRM: Japanese bone names mapped, morphs kept as expressions.