KKBP 7.1.0

See the readme for installation and usage instructions

Changes for V7.1.0

• Blender 4.2 LTS support!
  • Please note you need the new version of mmd_tools
• Koikatsu Sunshine exporter bugfix by @Guerra24!
  • This fixes colors not showing up on KKS exports that had their material set to "Koikano"
• Replaced Generated Face Normal smoothing with a new geometry nodes setup from @MoriMorinya! (original node group by aVersionOfReality)
• Added a button to import a single ripped animation from the game onto your model!
  • This feature requires Rokoko studio live plugin to be installed
  • This supports Mixamo animations too thanks to @hsxfunc
• Import KeyError fixes by @justturniphead!
• Chinese translation updates by @AnalogKnight!
• Normal maps are now loaded into the optimized material thanks to @FrankV724!
• The KKBP plugin can now generate a material atlas by itself!
  • The plugin also automatically generates a copy of your model that uses the atlas
  • This feature does not have a pixel limit, so if the atlas is too large, you can split up your objects and re-generate it
• Streamlined the KKBP main panel!
  • There's now only one button for importing, one for optimizing materials and one for exporting
  • If a button in the panel cannot be used, it will now be grayed out. Some features (like the animation import feature) require you to use the Rigify armature, and other features (like the prep button) require you to use the KKBP armature
• The plugin will now attempt to give you progress information during very long sequences, like when finalizing materials or bone simplification
• Generating dark colors and textures can now be skipped to slightly speed up import times
• Blue pixels on textures should now be fixed
  • This appeared to be an issue on certain blender versions. The textures are now generated by a python script, so this issue should not happen again.
• Updated the colors in the KK Shader to look good in the default "Blender dark" theme
• Updated the plugin to be a Blender 4.2 extension (it is no longer a legacy addon)
• Renamed the folders inside of the exporter zip to be clearer
• Added decompiled source code for the KKBP_Exporter.dll to the exporter zip (thanks to @Guerra24)
• Moved wiki and usage instructions to a github pages site: https://flailingfog.github.io

KKBP V6.6.3

⚠️ Please note this version is not compatible with Blender 4.0 or higher.
Check the readme for the Blender versions that are supported.

Major updates in V6.6.3:

• Blender export bug fix by @AnalogKnight!
• Removed LBS support

KKBP V6.6.2

Major updates in V6.6.2:

• The KKBP Exporter can now export with the current pose and face expression applied
• The KKBP Exporter has a new GUI
• Fixed a bug that prevented baking
• Multicolor hair and hairs with a maintex can now be imported

Click to show the full V6.6.2 changelog

Changes for V6.6.2

• KKBP Exporter improvements by @MediaMoots!
  • The exporter can now export with pushups enabled
  • The exporter can now export with the current pose applied
  • The exporter can now export with the current face expression applied
  • All sub meshes now have unique material names
  • All bones now have unique names
  • See #398 for details
• Fixed a bug that prevented baking
• Hairs with a maintex can now be imported
• Hairs with multiple colors can now be imported
• Hair detail will now show above hair fade
• The Blender import scripts in /importing/ were refactored
• Manual categorization was removed (because hairs can have maintexes now)
• The Blender plugin will now show a lot more progress information in the console and time every function
• Added a basic wiki

⚠️ See the readme for installation and usage instructions

KKBP V6.5.0

Major updates in V6.5.0:

• Blender 3.5 support
• The Blender Pose Asset Library button will now try to continue where it left off if you interrupt it

⚠️ See the readme for installation and usage instructions

KKBP V6.4.2

Major updates in V6.4.2:

• Huge speed improvements and fixes to the KKBP Exporter
• Added a button to create a Blender Pose Asset Library from exported Koikatsu animation files
• Added a button to create a Blender Map Asset Library from exported Koikatsu map files
• The console will appear during import now
  • The console will remain open if an error was encountered during the import process

⚠️ See the readme for installation and usage instructions

Click to show the full V6.4.2 changelog

Changes for V6.4.2

• KKBP Exporter improvements by @MediaMoots!
  • The exporter is up to 400% faster now!
  • Skirt bone structures will now be correct if you're exporting multiple outfits with differently sized skirts
  • MeshFilter accessories will now export from the game
  • Models can now be exported without the physics deformations applied, allowing you to apply your own physics to accessory / skirt bones later on
  • ShapeInfo values are now exported to KK_CharacterInfoData.json
• Added a button for creating a Blender Pose Asset Library from exported Koikatsu animation files
• Added a button for creating a Blender Map Asset Library from exported Koikatsu map files
  • This will only work properly if the Better FBX Importer is installed and enabled
  • If this addon isn't installed, maps and objects will still import, but their orientations and locations may be incorrect
• Added a button to "Finalize" a material
  • Finalizing materials will improve viewport performance during animation playback
  • This will replace the heavy KKBP node groups with a simple texture + toon shader
  • You need to bake light and dark versions of the model to a folder, then use the "Switch baked templates" button for the Light and the Dark selection before attempting to use the "Finalize materials" button
  • The original materials are saved as "material_name-ORG" if you need to go back to edit or bake them again
• Updated Rigify scripts (January 24th)
  • These contain a bugfix related to headmods
• The KKBP and Rigify armatures now have slight knee deformation drivers to smooth out the knee in kneeling poses
• On Windows, the console will now show during long operations (importing characters, baking, importing animations, etc)
  • This will help the user more easily identify errors. If an error is encountered, the console will remain open after the operation is complete
• Clothes without a shadow color will now generate a dark texture with a default shadow color (instead of not generating and appearing completely white)
• Using both the Rigify and Cycles options on the panel will no longer result in a rotated body mesh
• Dark textures are now created when the Import Studio Object button is used
• Only new textures will be saturated when the Import Studio Object button is used
• Baking materials should work on Linux and Mac now

KKBP V6.3.0

Major updates in V6.3.0:

• Blender 3.4 support
• The KKBP zip file now includes a script to generate a Rigify pose asset / animation asset library like this

⚠️ See the readme for prerequisites and usage instructions

Click to show the V6.3.0 changelog

• Blender 3.4 support
  • Models will no longer get a [KeyError 'color'] error during import
  • Baking with KKBP 6.3.0 now works on Blender 3.4
  • Baking with KKBP 6.3.0 will only work on Blender 3.4+ due to a change with the Mix node
• Added a script to generate a pose asset library from ripped Koikatsu animation data
  • Open the .py file in KKBP / extras / animationlibrary for usage instructions
• Importing is slightly faster for cards that have a lot of alphamasks or maintexes

KKBP V6.2.1

Major updates in V6.2.1:

• Automatic dark colors and textures for clothes
• KKBP Exporter updates and fixes
• Simplified Chinese translation
  • Current languages: English, 日本語, 简体中文
• The blender plugin should work on Linux and Mac now

⚠️See the readme for installation and usage instructions

Click to show the V6.2.1 changelog

• Dark colors and textures for clothes and accessories are now much closer to the in-game look!
  • 
  • This uses the darkening code from Xukumi KKShadersPlus
  • Dark colors are automatically set in the dark section of the shader
  • Dark versions of all main textures are created and loaded automatically (files that end in _MT_CT.png will be used to generate a file that ends in _MT_DT.png)
  • Dark colors for skin are no longer hard-coded
  • Dark hair and dark skin colors have a different darkening process. These processes aren't used yet, instead they get the same darkening process as the clothes
• KKBP Exporter updates by @MediaMoots!
  • Animation curve data is now exported to KK_DynamicBoneData.json
  • More headmods will now successfully export
  • Fixes to SMR data names
  • Eyes that have different overlays on different outfits will now be exported to the export folder (Only the first outfit's eye overlays will be loaded into blender automatically)
• Simplified Chinese translation by @castbohea!
• Cards missing certain body materials will now import without an error
• If KK shapekey creation for a headmod fails, the original shapekeys for the headmod will be preserved instead of being deleted
• The files for clothes and hair should correctly load in on Linux and Mac now (tested on SteamOS 3.3.2, Blender 3.3.1 flatpak)
• Transparency should work now when using Lightning Boy Shader
• Initial placement of the Lightning Boy Shader nodes is a little cleaner than before

KKBP V6.1.1

Major updates in V6.1.1:

• Rigify Armature updates
• KKBP Exporter and baking bugfixes
• Cycles and Lightning Boy Shader support
• You can save your addon option preferences now

See the readme for prerequisites and usage instructions

Click to show the V6.1.1 changelog

• Rigify armature updates by an anonymous contributor! (Changelog copy-pasted below)
  • 'Rigified' the new rigged tongue;
  • Moved the eyes and rigged tongue bones to their own layers to reduce clutter in the face layers;
  • Fixed the skirt bones alignment when converted, and also added the sixth bone (cf_j_sk_##_05) to the chains, just in case;
  • Characters without skirt bones are now supported;
  • Connected hair/accessory bones in the same way the CATS plugin does, and changed their widgets from 'circle' to 'limb' type, so the connections with their MCH parents are more apparent;
  • Enabled a small new Rigify adjustment to the toe bones for Blender 3.2+ (this one: https://www.youtube.com/watch?v=H80AjLWgECY );
  • Enabled a small new Rigify feature to the limb bones for Blender 3.3+, which allows you to scale the arms and legs uniformly by scaling the gear control bone at their base;
  • Now the script that is run after the Rigify conversion automatically changes parents and armature modifier targets to the generated rig for all mesh objects in the scene that are related to its metarig; it does it without relying on object names so it should be safe even with multiple characters in the same scene (it detects its metarig from a common bone with a random alphanumeric string in its name). In other words, there's no more need to parent objects with empty groups.
• Multiple bugfixes by @MediaMoots!
  • See #266, #257, #281
• Basic Cycles shader support!
  • This will make the KKBP materials work in Cycles
• Basic Lightning Boy Shader support!
  • This will attach the KKBP materials to LBS nodes
  • The LBS addon must be installed for this to work
  • Tested on LBS 2.1.3
• Baking changes
  • Bugfixes to the new baking system
  • The old baking system can now be accessed with the 'old baker' toggle on the KKBP panel
  • If Blender crashes during the baking process, the baking process will now resume where it left off instead of trying to bake everything again
• Added addon preferences
  • These won't reset when blender is closed
  • These are accessed in Edit > Preferences > Addons > KK Blender Porter

KKBP V6.0.0

Major updates in V6.0.0:

• Koikatsu Sunshine support
• Blender 3.3 support
• All 8 outfit slots are now exported at once
• Streamlined Blender import process

See the readme for prerequisites and usage instructions

Click to show the very long V6 changelog

Changes for V6.0.0

Huge feature and usability updates by @MediaMoots!

• The KKBP exporter now works in Koikatsu Sunshine!
• The KKBP Blender plugin now works in Blender 3.1+!
• All outfits are now exported!
  • These are automatically exported from Koikatsu
  • These are available as hidden objects after the model is imported into Blender. They are parented to the armature
  • If you don't want to use these, you can shorten your import time by deleting the "Outfit ##" folder from the export folder
• Alternate clothing states (shift / hang state) can now be exported!
  • Export these by checking the "Export Variations" box in Koikatsu
  • These are available as hidden objects after the model is imported into Blender. They are parented to the outfit object
• Hitboxes can now be exported!
  • Export these by checking the "Export Hit Meshes" box in Koikatsu
  • These are placed in their own collection when the model is imported into Blender
• The tears object is now exported and available as new shapekeys on the body object!
  • These are parented to the body
  • The tears material also has settings to allow minor color edits
• The eye gag object for heart eyes, firey eyes, etc is now exported and available as new shapekeys on the body object!
  • These are parented to the body
  • The shapekeys will automatically hide the eyes and eyeline materials when active
  • The swirly eye rotation speed, heart eye pulse speed and cry/fire eye animation speed can be changed in the Eye Gag materials
• The animated tongue is now exported!
  • This is parented to the body object and hidden by default
  • The rigged tongue doesn't use shapekeys like the rest of the face does
• Shapekeys are more accurate than before!
• The heart and sparkle Eye overlays are now exported
• Eyewhite shapekeys are fixed on the exporter-side now!
  • This means Blender is less likely to crash when importing the model
• Small fangs are now exported!
• Accessories are now automatically linked to the correct limb bone!
• Eye and overlay textures are now scaled automatically!
• Hair shine, eyeshadow, nipple and underhair UVmaps are now exported!
  • Thanks to that, these items no longer need to be set and scaled manually for each character
• Converted Normal Maps for use in Unreal and Unity are now exported
• Separated objects can now be exported with the "Export separated meshes" button
• A lot of character info is now exported
  • Check the .json files in the export folder for info on materials, accessories, objects, renderers and bones
• Exported character heights are 4% more accurate
• Texture suffixes are shortened
  • Image names over 64 characters long would cause blender to cufoff the filename, so this means long texture names are less likely to cause issues during import
• The Koikatsu / BepInEx console will now be print out each mesh being exported. If the exporter is not working for a specific character, accessory or clothing item, you can use this to track down what is causing the exporter to fail.
  • These messages are prefixed with [Info : Console]

Rigify armature updates by an anonymous contributor!

• Better Penetration bones will now be placed in the "Torso (Tweak)" layer when converting to the Rigify armature
  • You need to use the Better Penetration armature type in Koikatsu for these bones to appear

Unity normal blending and mirrored blush scaling by @poisenbery!

• Unity normal blending is an alternative normal map detail blending method that can be accessed in the "Raw shading" group
• Mirrored blush scaling is an easier way to scale the blush and eyeshadow if the texture is symmetrical. This can be accessed in the "Blush positioning" group on the Face material

Better face normals using shader nodes!

• The face now uses a bastardized version of the Generated Face Normals setup described in this post by aVersionOfReality
• This setup is disabled by default for performance reasons. Enable it by going to the face material > swap the "Raw Shading" node group to "Raw Shading (face)"
• This setup only works in Blender
• The GFN Empty position and scale can be edited by unhiding it. It's parented to the armature
• The GFN options can be edited in the node group called "Generated Face Normals" inside of the the "Raw shading (face)" group

Plus some misc changes to the Blender plugin:

• Added a one-click option for importing models!
  • Hair is now separated from the model automatically, so the entire import process has been reduced to a single button
  • The behaviour from V5.0 (where you can separate objects as you please) can still be accessed by changing the "Don't pause to categorize" option on the upper right to "Pause to categorize", then pressing the "Finish categorization" button when you're done.
• The main plugin UI can now be fully translated!
  • Current languages: English, Japanese (日本語)
• Material baking is now done through the use of Geometry Nodes!
  • This works with multiple UV maps, so you no longer need to create a new mesh for hair highlights or anything that uses a separate uv map
  • You can also speed up the baking process by skipping the dark and normal bakes if you don't want them
• Exporting can now be done without installing the CATS addon
  • Material Combiner is still required if you want a material atlas
• Added a simplification choices menu to the export prep button
• Removed the vanilla armature type toggle in favor of a menu
  • There's four options to choose from. Check the tooltip for a brief description of each option
  • The ability to switch between armature types after import was removed
• Shapekeys on clothes and hair objects are now deleted
  • Shapekeys only affect the face, so these weren't needed anyway
• The Eye, Eyebrow, Eyewhite, Eyeline and Nose materials are now marked as freestyle faces by default (for freestyle exclusion)
• Lipstick and Flush textures are now loaded into the face material
• Added a safe for work mode toggle that probably works
• The permalight/permadark texture has been merged into one file
• Python errors are now copied to the KK Log in the Scripting tab on the top
• The import directory string listed in the KK Log is now censored if it detects your Windows username
• The plugin now uses an HDRI from polyhaven
• All KKBP panel options are now visible by default
• The KKBP panel will now gray out some buttons after a model is imported

And many bugfixes!

KKBP V5.1.1

Known bugs with this release

• During export, the blender plugin will not use CATS to automatically merge the useless bones on armature layer 11. The line that does this was accidentally commented out. The bones can still be merged manually using the Model options menu in CATS.
• The "2b)" button and the "4)" button in the blender plugin seems to be incompatible with Blender 3.1. Use Blender 3.0 or 2.93 for now when doing that step.

Changes for V5.1.1

• Added per-character light linking to the KK shader
  • If you have multiple characters in a scene, this allows you to "link" a light to a character, so you can achieve ideal lighting for each character and not have to fiddle with a global lighting setup that affects all characters at once. This works for up to three characters / light sources. It's enabled by default and can be found inside of the Raw Shading group.
  • Usage: Enter the Raw Shading group then make sure the "Light linking options (open me)" group framed in pink has it's slider set to 1, and any red lights will light your character. Import a second character, return to the ""Light linking options (open me)" group, and open it. Change the output of the pink "Match RGB output and sunlight color for light linking" frame from R to G. Any green lights will light the second character, but not the first character. Using a yellow light will light both R and G characters. Using a white light will light all characters.
    
• Added reaction to colored light to the KK shader
  • When you use a light that isn't pure white, the colors on the model will become affected by the color of the light. This is disabled by default and can be found inside of the Raw Shading group. Colored lights and light linking can't be used at the same time.
  • Usage: Make sure the "Light linking options (open me)" group framed in pink has it's slider set to 0, and any colored lights will add additional color to your character. Any white lights will light the model like normal.
    
• Updated Rigify scripts to the latest version (Feb 24th)
  • These include bugfixes for handling duplicate bones
• Overlay masks for Body and Face shaders now retain their original color.
  • The "Overlay color" inputs on the body/face shader that used to set the overlay color have been changed to "Overlay color multiplier" inputs. Keep this as a white color to preserve the overlay mask's original color. If the overlay is pure white itself, the color on the multiplier will just set the color of the overlay.
• Added an image slot for the "plain" version of the maintex for clothing items.
  • These weren't automatically loaded in if a CT version of the maintex was available
  • This can be accessed by going into the clothing shader group and setting the "Use colored maintex?" slider to zero
  • If there's a CT but no plain version available and you try to use the slider, you'll get a pink placeholder texture as a warning
• The permanant light and dark image masks in the raw shading group have been moved to the green texture group
  • This removes the need to create a unique raw shading group for every material.
    
• Bugfixes (#94, #90, #105, #114)