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!)

Features

• Near perfect mesh and texture replication
• All face / tear / cartoon eye expressions available as shape keys
• Can import animations and poses from the game
• Works in EEVEE and Cycles
• Fully featured Rigify armature
• Export the model as .fbx for Unity VRM or Unreal Engine
• Easily edit colors for most materials, just like in the game!
• SFW mode

How to use it

Export the card from Koikatsu

(click to show export instructions)

1. Install the dependencies

   • The easiest way to mod your game and install all dependencies is the HF Patch for Koikatsu or the HF Patch for Koikatsu Sunshine
   • If you are already using the pre-modded Better Repack, you need to do one of the following:
     • manually install the "Character Maker Poses" zipmod
       • Koikatsu link
       • Koikatsu Sunshine link
     • OR, update your mods using the auto-updater in the launcher
     • OR, install the HF patch over the repack
   • If your game is already modded, but you don't want to install the HF patch, just install KKAPI, KK accessory slots, KK pushup, and the poses zipmod linked above

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. After you click the button, 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 - The exporter plugin for this project
• SKLX-creator - Export Koikatsu cards to Blender
• KKPMX - Export Koikatsu cards to MMD
• Koikatsu Pmx Exporter (Reverse Engineered & updated) - The original Koikatsu mesh exporter decompiled and updated
• SVS CharacterExporter - An experimental character exporter for SVS