Convert OBJ to PMX

MikuMikuDance and compatible applications require PMX for models with bones, morphs, materials, and physics, while OBJ normally contains only static mesh data. Conversion is needed when an OBJ asset must be posed, animated, or used in an MMD scene.

What the OBJ format is

OBJ is a plain-text 3D interchange format that stores vertex positions, texture coordinates, normals, polygon faces, and optional material references. Its companion .mtl file describes basic materials, while image textures remain separate files.

Blender, Maya, 3ds Max, Cinema 4D, ZBrush, MeshLab, CAD applications, scanners, and model libraries commonly use OBJ for exchanging static geometry. OBJ does not store armatures, skin weights, animation, facial morphs, rigid bodies, joints, or MMD-specific shading settings.

What the PMX format is

PMX is the main MikuMikuDance model format. MMD, MikuMikuMoving, PMX Editor, and Blender with a compatible mmd_tools release can use it.

A PMX file can contain mesh data, vertex weights, materials, bones, morphs, display groups, rigid bodies, joints, and model metadata. Texture images are normally still external files referenced by the PMX materials. PMX is therefore a model-and-rig format, not a more compact replacement for OBJ.

How to convert OBJ to PMX

Blender with a version-matched mmd_tools release is the most practical general workflow. Add-on compatibility changes between Blender releases, so use the Blender version specified by the add-on documentation rather than installing an arbitrary combination.

1. Install Blender and the matching mmd_tools add-on. In Blender, use Edit → Preferences → Add-ons → Install, select the add-on archive, and enable it.
2. Place the OBJ, its .mtl file, and every referenced texture image in an accessible folder. Import the model with File → Import → Wavefront (.obj) and enable material and image loading when those options are available.
3. Check the model in Material Preview. Relink missing images with File → External Data → Find Missing Files or through the Shader Editor. Preserve the texture files and use relative paths where possible.
4. Clean the mesh before export: remove unwanted objects, apply the intended scale with Object → Apply → Scale, recalculate outward normals with Edit Mode → Mesh → Normals → Recalculate Outside, merge accidental duplicate vertices, and reduce excessive polygon density.
5. For a static PMX, select the mesh and use the mmd_tools PMX model export command. Its location varies by add-on release, commonly appearing in the MMD properties or under File → Export. Choose an encoding supported by the target MMD application and save the .pmx file.
6. For an animated character, import or create an armature before exporting. Starting with a legally usable MMD base model or rig template is usually faster than building a complete skeleton from scratch. Fit the OBJ to the armature, transfer or paint vertex weights, and configure the required center, leg, foot, eye, facial, and display bones.
7. Create facial or corrective morphs with Blender shape keys and expose them through the MMD morph setup. Add rigid bodies and joints only after bone deformation and weights work correctly.
8. Open the exported PMX in MikuMikuDance or PMX Editor. Check textures, material properties, bone poses, morphs, toon shading, transparency, outlines, and physics. PMX Editor is useful for post-export corrections, but it does not automatically rig arbitrary OBJ geometry.

Quality and compatibility limits

A direct OBJ export can produce a PMX that displays a static mesh, but it cannot infer the skeleton, weights, facial morphs, or physical joints of a finished MMD character. For clothing or accessories, fitting the OBJ to an existing PMX armature is usually more efficient than creating a new character rig.

Material conversion is approximate. MTL commonly supplies diffuse color and a texture reference, whereas PMX materials also support toon textures, sphere textures, edge settings, alpha behavior, and MMD-specific shading parameters. Recheck transparent surfaces, back-face visibility, outline width, and texture paths after export.

OBJ may contain triangulated or very dense geometry and does not preserve animation. Preserve UV seams, inspect smoothing, fix non-manifold areas, and avoid unapplied negative scale. Unsupported shader nodes and missing texture files will not become equivalent PMX materials automatically.

There is no dependable general-purpose online OBJ-to-PMX service for a complete MMD model. Web converters can sometimes translate static geometry into generic formats, but they cannot create an appropriate skeleton, MMD morphs, or physics setup. Keep the conversion local with Blender and mmd_tools; use PMX Editor for Windows-based inspection and finishing.