KKBP Importer

This is a plugin pack for exporting Koikatsu cards to Blender.

The KKBP Exporter exports the card's textures, mesh and armature from the game. The KKBP Importer uses that data to setup the character in Blender.
Imported characters can be used in Blender for animations, renders, etc. They can also be converted to FBX files to use in other programs.

• Download
• Alternate download (this is a live snapshot of the repo that might not work!):

How to use it

Export the card from Koikatsu

(click to show export instructions)

1. Install the HF Patch for Koikatsu or the HF Patch for Koikatsu Sunshine
   Better Repack will not work unless you do one of these:
   a. manually install the T-pose mod
   b. update your mods using the auto-updater in the launcher
   c. install the HF patch over the repack

2. Find your Koikatsu install directory and drag the KKBP exporter .dll into the /bepinex/plugins/ folder

3. Start Koikatsu and open the Character Maker

4. Enable the KKBP Exporter window.
   

5. Click the "Export Model for KKBP" button at the top of the screen. This may take a few minutes depending on your computer hardware.

6. A folder in your Koikatsu install directory will popup when the export is finished

Import the model to Blender

(click to show import instructions)

1. Open Blender 5.0. Other versions are not guaranteed to work. Click here if you are not using Blender 5.0

2. Install mmd_tools in Blender

3. Install KKBP Importer 9.0 in Blender

4. After you install both addons, you can click the "Import model" button in the KKBP panel. An explanation of all import options can be found here
   

5. Choose the .pmx file from the export folder

6. The blender console will appear and begin importing the model. This may take a few minutes depending on your computer hardware
   

7. Check there were no errors during import in the scripting tab. A successful import will end in "KKBP import finished in XX minutes"
   

(Optional) Exporting as fbx

(click to show fbx export instructions)

1. If you want to reduce the bone count, or convert the model's armature for VRM / VRChat / Unreal Engine, click the "Prep for target application" button in the KKBP panel. This will also create an atlas file for your body / hair / clothes and save them to the atlas_files folder in your export folder

2. Hide the original collection in the outliner and show the new collection

3. Click the export button in the collection tab to export an fbx file to the atlas_files folder in the export folder

Help

Check the wiki for FAQ and basic info.
If you're still having trouble please create a new issue.

Contributing

Any contributions are welcome! Please check out the links below:

• The issues page
• Make a pull request
• Translate the KKBP interface

Similar Projects

• KKBP Exporter
• SKLX-creator
• KKPMX
• Koikatsu Pmx Exporter (Reverse Engineered & updated)
• SVS CharacterExporter