KK Blender Porter Pack

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.

Download

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

Usage Instructions for V6

Required software:

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.

Exporting from Koikatsu and importing to Blender:

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.

Exporting from Blender to fbx:

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

Video walkthrough of all plugin options

(Click for playlist!)

Help

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

Contributing

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.

chlamydomonos / kk-blender-porter-pack Goto Github PK