literature

Tutorial: Export Koikatsu to MMD (PMX)

Deviation Actions

JapanYoshi's avatar
By
Published:
86.7K Views1 Collected Privately

Literature Text

This is for the people who want to export Koikatsu models to MMD, but hate this video guide. I for one hate pausing, unpausing, seeking through, fullscreening to see the details, and everything wrong with video guides.


What you need

  1. The base game Koikatu / Koikatsu Party (sold on Steam, NSFW) or V-Katsu (free on Steam). V-Katsu won’t let you export models by default, but plugins will let you do it anyway. This guide will assume you have Koikatsu / Koikatsu Party.
  2. BepInEx. This allows modding of most Unity games.
  3. PmxExport for BepInEx. This does the initial exporting from the game to MMD.
  4. PMXEditor. If the raw export crashes MMD, use this to fix the issue.
  5. Recommended: XUnity Auto Translator. This translates the Japanese interface into English (though not perfectly, not even close, because it’s all machine-translated).

Steps to Export

1: Install BepInEx.

If you have a modded copy, you may already have the folder Koikatsu\BepInEx. In that case, please skip this section.

If you don’t have BepInEx, download version 4.1.2 from here, and follow the instructions here.

2: Install the mods

To install PmxExport and XUnity Audio Translator, download their respective files and place their .DLL file in the folder Koikatsu\BepInEx.

3: Load the character editor

Boot the main game. If PmxExport is correctly installed, a button labeled “Export” should appear on the top left of the game window. Click “Char Maker” and select either “Female” or “Male”, the option where you can load your desired character.

4: Load the character you want, and set up their outfits/accessories

Go to the documents tab and load the character you want. Before you press “Export”, you can edit their clothing state, as well as show or hide their accessories.

5: Press “Export”

The model data should be in the path C:\koikatsu_model. (Ew, hardcoded paths, I know.)


The exported model may not work on MMD right away. The raw exported model has many, many more bones, polygons, morphs, than a normal MMD model. If it doesn’t, you need to use PMXEditor.

Steps to Fix the Model

1: Load the model on PMXEditor.

Load the exported file model.pmx into PMXEditor.

2: Change their name

If you want to change the name of your exported model, you may do so in the “Info” pane.

3: Set encoding to UTF-16 (Little Endian)

In the “Info” pane, set Encoding to UTF-16(LE).

4: Recolor the tongue

In the “Material” pane, select the tongue material (misspelled as “tang”) and change the Ambient color to a more fleshy color. If any other parts of your exported model don’t look right, you can edit their material here.

5: “change some morph tabs just for future use” (not my words, idfk what this means)

I guess some morphs are bound to the wrong “panel”? Fuck knows, just watch the video and tell me what OP meant.

6: Delete bones named “-1”

Go to the “Display Pane”. Go through each group and delete any bone named “-1.

7: Save as new

To the same folder, save the edited PMX file using the option File > Save As....

8: Troubleshoot issues

You can troubleshoot issues in the model using File > PMX Info (F). However, the results will be in Japanese.

9: Delete unnecessary physics bones

It is wise to delete unnecessary physics bones. For example, if your model does not wear a skirt, use the “Joint” tab to delete all physics bones whose name starts with cf_j_sk_. Then go to the “Body” tab to delete all bones whose name also starts with the same thing.


Note for after installing PmxExport


The PmxExport plugin forces everyone to T-pose in the character editor in Koikatsu. You can disable PmxExport when you don’t need it using KKManager.

Deviation Actions

Comments67
Join the community to add your comment. Already a deviant? Log In
Captain-Kerfuffle's avatar

I don't understand how I',m supposed to install the Auto Translator. You say I need to place it's DLL file into Bepinex but there are several. Which one or do I place them all?