KKBP Wiki

Check the version table if you are not using Blender 4.2

Usage Instructions for V7

The last known working configuration for Koikatsu / Koikatsu Party as of writing this text is HF Patch v3.28, Koikatsu 5.1, Blender 4.2.2, KKBP Importer 7.2.0, KKBP Exporter v4.30, mmd_tools 4.2.2
The last known working configuration for Koikatsu Sunshine as of writing this text is HF Patch for KKS v1.17, Koikatsu Sunshine 1.1.4, Blender 4.2.2, KKBP Importer 7.2.0, KKBP Exporter v4.30, mmd_tools 4.2.2

  1. Install the HF Patch for Koikatsu, or the HF Patch for Koikatsu Sunshine.
    Pre-modded repacks will not work unless you update with the repack’s auto-updater or install the HF patch. Click here for workaround #1. Click here for workaround #2.
  2. Find your Koikatsu install directory and drag the KKBP exporter into the /bepinex/plugins/ folder
  3. Start Koikatsu and open the Character Maker
  4. You’ll see this UI at the top now.
  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. A folder in your Koikatsu install directory will popup when the export is finished
  6. Open Blender 4.2. Other versions are not guaranteed to work.
  7. Install mmd_tools in Blender
  8. Install KKBP Importer 7.2.0 in Blender
  9. After you install both addons, you can click the “Import model” button in the KKBP panel
  10. Choose the .pmx file from the export folder
  11. The blender console will appear and begin importing the model. This may take a few minutes depending on your computer hardware
  12. Check there were no errors during import in the scripting tab. A successful import will end in “KKBP import finished in XX minutes”
  13. If there were no errors, you can start using the model as is, but it is recommended to finalize the materials first. If you use the model as is, it can take a long time to compile all the shaders. If you finalize the materials then the shaders will compile very quickly. It also makes the shaders compile quickly if you decide to reimport the same model. Finalizing the materials can take a few minutes depending on your hardware
  14. If something doesn’t look right and you don’t see any errors in the log, check the Wiki Home on the sidebar.
  15. If you got an error during import, check the FAQ, or search the issues page on the Github repo to see if anyone else has your issue.

Exporting from Blender to fbx:

  1. Click the Finalize Materials button in the KKBP panel
  2. This does three things
    • Finalizes all of the materials to png files and saves them to the baked_files folder in your export folder
    • Creates an atlas file for your body / hair / clothes and saves them to the atlas_files folder in your export folder
    • Creates a new collection that uses the atlas
  3. Hide the original collection in the outliner and show the new collection
  4. Click the “Prep for target application” button if you want to reduce the bone count or convert the model’s armature for VRM / VRChat
  5. Click the export button in the collection tab to export an fbx file to atlas_files in your export folder