Plugin pack for exporting and setting up Koikatsu characters in Blender.
The KKBP exporter for Koikatsu is used to export the character's mesh, armature and color data. The exported data is then processed by the KKBP plugin for Blender. Once characters are setup in Blender, they can be saved as FBX files for use in other programs.
The wiki can be found here.
The changelog can be found here.
Stable versions of KKBP are on the release page.
The absolute latest version of KKBP can be downloaded here (this is a live snapshot of the repo that might not work!)
| Software | Version |
|---|---|
| HF Patch | Install HF Patch v3.16 or later for Koikatsu Install HF Patch v1.7 or later for Koikatsu Sunshine |
| Blender | Install the latest version of KKBP for Blender 3.6 Install KKBP 6.4.2 for Blender 3.4 Install KKBP 6.2.1 for Blender 3.3 |
| PMX Importer | Install either CATS or mmd_tools to Blender (it doesn't matter which) |
The last known working configuration as of writing this text is HF Patch v3.22, Koikatsu 5.1, Blender 3.6.2, KKBP for Blender 6.6.2, KKBP Exporter v4.30, mmd_tools 2.9.2, Material Combiner 2.1.2.4.
Click to expand!
Install KKBP for Koikatsu by copying the KKBP_Exporter.DLL into the plugins folder: C:/Koikatsu install directory/BepInEx/plugins/
(Don't mix KKBP Exporters and KKBP Blender Plugins from different releases! For example, if you are using KKBP release 6.6.2, you must use KK-Blender-Porter-Pack-V6.6.2.zip with KKBP_Exporter_V4.30.zip)
| Game | Plugin version |
|---|---|
| Koikatsu Koikatsu Party |
Use the .dll file in the net3.5 folder |
| Koikatsu Sunshine | Use the .dll file in the net4.6 folder |
- Start the game, go to the character creator and load your character
- Click the "Export Model for KKBP" button on the top of the screen. This may take a few minutes depending on your hardware. A folder will popup when the export is finished
- Copy the entire folder generated by the plugin to your desktop. This folder is located in C:/Koikatsu install directory/Export_PMX. The format of this folder is ######_CharacterName.
- Open Blender and make sure KKBP and one of the PMX Importers above are installed in the Blender addon menu
- Click the Import Model button in the KKBP panel and choose the .pmx file from the export folder. This may take a few minutes depending on your hardware.
Click to expand!
- Save a backup file of your finished model
- Choose which export type you want in the KKBP panel. There's currently a targeted export type for Unity (VRM and VRChat), and a generic fbx type for everything else
- Click the "Prep for target application" button
- Click the "Bake material templates" button and choose the folder you want to store all of your baked images to (warning: there's going to be a lot, so an empty folder is recommended)
- Create an altas for the body, clothes and hair objects using the material combiner addon
- Hit the undo button to return to the state before you created the atlas. Change the menu under the "Apply baked templates" button from "Light" to "Dark" and click the button to load in the dark textures. Use material combiner again to generate the dark version of the material atlas
- Click the export FBX button in the KKBP panel to invoke the built-in fbx export dialog
Check the wiki for FAQ and basic info.
If you're still having trouble please create a new issue.
If you're interested in contributing, please check the issues page or make a pull request.
If you're interested in editing the wiki, check this folder.
If you're interested in translating the plugin interface into your language, check this folder for examples.
(Current languages are EN, JP, ZH.)
This project does not accept donations.