Visit LearnMMD.com on Facebook!.
Keep the Faith-MMD... Learn to be a responsible MMDer! .

Export Import MMD Models Using Blender and PMXE

A feature article by GloriaTheAnimator!Oh, hi… its me! Teaching you how to /import/export in blender because Metasquoia is not free and not good and Blender is free and good… ;)

How to Export Import MMD in Blender

So, for this youI ‘ll need…

Note: click on the names to download them




Make sure your system meets the requirements.

OK, we got our software… now we need Blender plugins.

Get these plugins…



The MMD_Tools plugin will let you load mesh/vertices/polygons models but without any bones or anything like that.

… and Meshio will allow you to export the model as pmx

I recommend it only for exporting mesh; never had an export with bones with it, not sure how that will work!

OK, so, I have modeled something here…

I created this model in Blender so I could show yo how to export an object for use in MMD... MMD in Blender

… to show you an example of how easy it is to export stuff.

Be sure you are in Object Mode.

If you have both plugins installed, now you go to FILE and hover over Export and click miku miku dance model

Go to FILE and hover over Export and click miku miku dance model

Now it will ask you where to save…

I recommend going to windows explorer and copy and paste the place where you wanna save so its easier to navigate.

Great! Now its saved.

Open PMXEditor and open the pmx file you saved.

You have your file… though you do need to make the settings correct to make the shadows work, and stuff. Don’t forget to add toon files to make the shadows work.

Oh, and if you will save it and try to Open in MMD, it will not work… because MMD has its own rules for the models…

… and if the rules don’t match, MMD will crash!

Those rules are:

1: must have bones

2: must have all working joints (if you don’t have any joints it will work, too)

… and there are a few more rules… but I only know these from my experience.


OK, since you have added a bone it will automatically be rigged, too, so don’t worry about rigging everything to one bone. Scale the thing up because it exports it at quite a small size.

If you like the size, sure, but for me all the stuff I export is really small… so, you click move at the top of pmx view or f4 if you are a shortcut fan like me.

Now select everything and scale it up while holding scale in object manipulation.

SAVE and open it up in MMD… it should work now!

Happy modeling ^-^


Visit the LearnMMD.com Homepage! Plenty of Mikumikudance instruction and info!


  1. ahmad ahmad
    July 23, 2018    

    I am using blender 2.79 and mmd tools plugin is working properly but meshio isn’t working for me,I even tried older versions of the plugin file but none appears in the add-ons tab

  2. jhon daveson jhon daveson
    June 18, 2018    

    i have another problem here im using blender and i tried to rename the bones i already have in English to Japanese but don’t know how so anyone got any ideas?

    • June 18, 2018    

      That’s why I said that you can not do it all without finishing it in PMXE. Separate Japanese and English name fields are a feature of PMX model format, Blender is simply not aware of them. It is a powerful editor and a great help, no doubt about that… but using MMD_Tools does not make it an MMD tool, so to speak. Not the native one.

    • June 21, 2018    

      You absolutely should not translate Japanese bone names in Blender.

      Japanese bone names, at least the key ones, are required by MMD for the model to work normally. This means that without these names, most motion data will not work with the model.

      English translated bone names are merely labels and in themselves have no technical functionality. These fields can in fact be in any language or even glibberish, and the model will still work so long as the required Japanese bone name set remains intact.

      If you add a new bone for something that is not in the mandatory bone set, the name can be in English and the model will still work.

    • June 22, 2018    

      If you use MMD Tools plugin, you’ll find that it adds new categories (custom data) to your bone tab. In these fields, you can specify a Japanese and English name for export.

      If you’re not interested in export, but are animating solely in Blender and want to import animation data for .vmd files, just rename your Blender bones (and vertex groups, but IIRC Blender does that for you) to the appropriate Japanese names.

  3. jhon daveson jhon daveson
    June 13, 2018    

    hi im wondering if any of you people are highly experienced in mmd tools
    i have a model here that i rigged and use for mmd but when i add the motion to this model the only thing that actually moves is the master bone.

    so im wondering if any of you people can somehow fix this problem that i have.

    • June 13, 2018    

      Are you sure that your model is rigged AND weighted properly?

      • jhon daveson jhon daveson
        June 14, 2018    

        yes it is. also im doing this in mmd tools in blender but when i play the motion the bones don’t follow it olny the root bone does.

        • June 14, 2018    

          If you move a random bone manually in MMD, does the body react properly? Do all your bones have correct Japanese names?

          • jhon daveson jhon daveson
            June 15, 2018    

            no just English names like master bone.001

            • June 15, 2018    

              Well, that’s your answer, then. Both pose and motion data (just like absolutely everything else in MMD) refer to models’ bones by their Japanese names that must match the standard scheme.

              • jhon daveson jhon daveson
                June 16, 2018    

                so the motion or poses just wont work unless i rename them to japanese? like 武器,頭 and 指?

                Do you have a worksheet on how make sure it’s done right?

                • June 16, 2018    

                  More precisely, unless you fill Japanese name fields with those names, yes (English fields are only for convenience, and many Japanese model-makers just leave them unattended).

                  Off the top of my head, I can’t think of a way to *easily* rename all bones from arbitrary names like bone.001. Depending on how well you know your model, it might be quicker to use one of two methods: open two PMXE windows side-by-side, one with your model and another with a well-developed model that already has all bones named, and find an equivalent for each (invisible “destination” bones you can skip for speed). Or, you can select all bones in the main window’s Bones panel’s list, press Ctrl-C, and paste the result into a simple text editor, like Notepad++ (a regular Windows Notepad may garble Japanese characters to you). Then fill Japanese fields in the text, and copy-paste bones’ descriptions back into PMXE.

                  The Excel table also may or may not be of help to you.

                  • jhon daveson jhon daveson
                    June 17, 2018    

                    So…i guess i have to rename masterbone.001 to
                    This? >マスターボーン.001 in the Japanese field to each name of each bone like that?

                    And btw since im doing this in blender using mmd tools its not necessarily recommended to use pmxe since i have all those features in blender it’s just i have to operate differently so notepad and excel will be useless if have to rely on that first.

                    • June 17, 2018    

                      The masterbone should be called 全ての親, the centerbone should be センター, no “.001” or some other nonsense. *Each* bone must be named *exactly* as their equivalents are called in other MMD models, that’s why I offered to open two corresponding models side by side in PMXE, to get proper names that should be there. If you can name them properly using mmdtools, godspeed to you. You’re free to do in Blender anything it is capable of, just don’t expect the result to be ready out of the box for using in MMD without final polishing.

                    • jhon daveson jhon daveson
                      June 17, 2018    

                      That’s fine by me if renameing them equivalently does solve my problem but somehow still becomes incomplete in mmd i will surely let you know otherwise.

                      Btw do you know anyone else here that has better experience in blender besides mae?

                    • June 17, 2018    

                      Well, there’s also bandages, he works in Blender a lot.

  4. Ole Ole
    May 29, 2018    

    do i need to add a color from the pmx editor, or can i just add a color to an object straight from blender?

    • June 6, 2018    

      While it’s possible to specify the colors you want from Blender, that’s a situation where it’s probably better to do it in PMXE, because it’s actually easier, and Blender won’t give you a proper MMD preview anyways– what a color looks like in Blender won’t be what it looks like in MMD.

      • jhon daveson jhon daveson
        June 17, 2018    

        So bandages do you know how to make a model in blender using mmd tools without pmx editor?

        • June 21, 2018    

          ALL models made in ANY 3D program that is intended for use with MMD MUST be processed using the PMD or PMX Editor, with the possible exception of Metasequoia (Japanese version with the relevant plugins).

          MMD models have their own set of technical requirements and particular ways of doing things, so this is why these extra steps are required.

        • June 22, 2018    


          Make a cube or whatever. Shift-a add armature->New MMD model. Parent your cube to your new armature. Export to .pmx .

          You don’t need to do cleanup in PMXE.

          But for a lot of things, it’s still smarter to do them in PMXE following export. For example, it’s difficult and slow to get Blender to show you accurate material previews, while PMXE will show them to you right away. Physics for MMD models are, in most respects, easier to edit in PMXE. And for some advanced bone work, Blender and MMD do not agree, so it is better to do that kind of work in PMXE. (Bur for any realistic bone work, doing it in Blender and exporting via MMD tools is fine.)

          • Adhitya Adhitya
            December 17, 2018    

            Hi… I have a model that I created using the makehuman plugins for blender.
            The Question is :
            – when I try to export the pmx file using the mmd tool, I don’t find the pmx file in the directory. I have used the mmd_tool plugin according to the suggestion given (blender_mmd_tools-dev_test)
            – when I try to export the pmx file using Meshio plugin the pmx file is successfully generated, but when I import to PMXE, only a portion of the object appears, in this case, only body parts are available, while the other parts are missing.

            is there something wrong with this?

            Thank you

            • December 17, 2018    

              Look for error messages on the console. If you don’t get any error messages, consider making a bug report for either. There are a number of ways that a model can be messed up, and sometimes when the plugins don’t know what to do with something, they just give up.

              Consider breaking the model down into parts. Does the hair export properly? Do the pants? Then those aren’t the problem, something else is. Export mesh + MB only, export armature only, export armature + physics only to rule out sources of your problem.

              https://www.deviantart.com/hogarth-mmd has some experience with exporting make-human models to MMD and might share likely sources of trouble. I’m not familiar with that add-on myself. If you want to send a file to MMD, it’ll probably reach me and I’d take a closer look at it.

  5. 8bit_coder 8bit_coder
    April 23, 2018    

    I exported the blender model to PMX, added bones and shadow but MMD crashes every time I try to open it. What am I doing wrong?

    • April 23, 2018    

      Try using file->PMX info in PMXE and copy/pasting the text into a translation service. It should give you a list of issues with your model, good places to look to fix things. If you fix all issues listed, please feel free to send us a copy of the model and we will be happy to take a look at it.

  6. Ervin Deloach Ervin Deloach
    April 7, 2018    

    Also when it come to mmd tools every time i import a model to blender the whole app shut off, can anyone give me a bucket of ideas?

    • April 7, 2018    


      I don’t use Pymeshio, but you might want to look up the author’s Github page and create an issue there if you have a problem.

      I use mmd_tools. I wouldn’t recommend the link on this page, as it links to an older version; there is a newer fork with a lot of improvements at https://github.com/powroupi/blender_mmd_tools .

      So what I’d recommend doing is uninstalling and deleting Pymeshio and your version of mmd_tools and installing the new version from that link. Powroupi’s mmd_tools fork is very stable, very useful, although there are still a few remaining issues with it.

  7. Ervin Deloach Ervin Deloach
    April 7, 2018    

    So… does anyone know how to solve this problem when ti comes to Exporting and importing pmd and pmx models?

    location: : -1
    importError: No module named ‘blender26- meshio.pymeshio from .pymeshio import pmx
    file “/blenderportable/app/blender/2.78/scripts/addons/blender26-meshio/import_pmx.py
    line 16, in
    from. import import _pmx
    file E:/ blenderportable/app/blender/2.78/scripts/addons/blender-meshio/__init__.py
    line 89, in execute
    traceback (most recent call last):

  8. Matryoshka Matryoshka
    October 28, 2017    

    It WOULD be good if you included how to install MMD Tools and Meshio to Blender. I have NO IDEA how!

    • October 28, 2017    

      No idea about Meshio. Don’t use it.

      But MMD Tools has installation instructions on its wiki at https://github.com/powroupi/blender_mmd_tools/wiki/Documentation.

    • October 29, 2017    

      Generally a procedure to install Blender plugins is: download it, launch Blender, select “File->User Preferences->Addons”, and click “Install from File”. Find the .zip you downloaded and install it. After that, find its titles in the list of installed plugins and enable it. Wait some time for it to activate, and you’re good to go.

      • Matryoshka Matryoshka
        October 29, 2017    

        Thanks. I tried it, but it doesn’t seem to be exporting for some reason.

        I got a .rip file from an exe game, used Noesis to turn it into an OBJ file and then used Blender to make it a PMD file and it doesn’t even show up in the folder! And I tried to make it a .x file and that doesn’t show up in MMD! I don’t know what I’m doing from.

        • October 30, 2017    

          FWIW, I believe Blender has a native export to .x file (although it may require enabling a built-in addon, I can’t remember.) Obj files don’t have much in the way of extra info like weights, just vertices, UVs, and textures, so an .x file is fine for that.

          FWIW, I’ve had problems with the PMXE import from .obj feature myself. I suspect it’s not implemented very well.

          As far as exporting to .pmd, it sounds like it’s not getting exported whatsoever. The usual reason for this is that MMD Tools doesn’t know what it’s supposed to be exporting (but you should check the Blender console for error messages too.) You’ll need to join a mesh to an MMD model in Blender for it to get exported. You can do this via the attach meshes button or by parenting the mesh to the armature of an existing MMD model. For more information, check out the wiki, which I linked above.

  9. Mae Mae
    August 5, 2017    

    Hi there! When I try to export the object using MMD tools in Blender, sometimes it doesn’t save the file at all. Other times, it saves it but nothing shows up in the PMX editor.

    Please help :( This is driving me insane.

    • August 5, 2017    

      It depends on what version of MMD tools you’re using, but there are a number of things that could be happening.

      The first thing that I’d do is recommend the updated version of MMD Tools at https://github.com/powroupi/blender_mmd_tools which will lead to this problem less frequently.

      Once you do that, take care with your objects, how you join and separate them. If you are trying to combine multiple models, instead of just editing a single model in Blender, save and export often, just to make sure you haven’t done anything that will break it. I recommend you import everything you’re going to need into a single PMX to take into Blender, and then only use the objects in that file– not even any primitives! That’s the safest bet, at least.

  10. XxUnna-Chan XxUnna-Chan
    July 16, 2017    

    Um… Excuse me Gloria. Do you know how to post in this? Because idk how you post.

  11. Öykü Öykü
    July 10, 2017    

    How can I add blenders to your add-ons? (Sorry my english is so bad)

Leave a Reply

Your email address will not be published. Required fields are marked *

Download the latest version of MMD MikuMikuDance! Step-by-step instructions to help you make an MMD Music Video! bo-beep-bo-beep! LearnMMD's Step-by-Step MMD instructions for MikuMikuDance!

MMD Tutorials:

Really Learn MMD as you face the 15-second Animation Challenge!

Visit LearnMMD.com on Facebook!