A BepInEx plugin for Koikatsu and Koikatsu Sunshine.
  • C# 98.6%
  • PowerShell 1.4%
Find a file
crmbz 8cd3f7dd71 added OR between the games
you obviously don't need to have both at the same time to use the plugin for one of them.
2026-06-16 01:32:51 +00:00
KK Reformat all source files for consistency 2026-06-16 03:01:45 +02:00
KKS Reformat all source files for consistency 2026-06-16 03:01:45 +02:00
libs dev 2025-10-16 14:51:56 +05:00
Shared Reformat all source files for consistency 2026-06-16 03:01:45 +02:00
.gitattributes Add .gitattributes, .gitignore, README.md, and LICENSE.txt. 2025-09-19 14:21:52 +05:00
.gitignore Add .gitattributes, .gitignore, README.md, and LICENSE.txt. 2025-09-19 14:21:52 +05:00
Anisotropic Morph.sln dev 2025-10-09 13:23:26 +05:00
LICENSE.txt Add .gitattributes, .gitignore, README.md, and LICENSE.txt. 2025-09-19 14:21:52 +05:00
README.md added OR between the games 2026-06-16 01:32:51 +00:00
release.ps1 dev 2025-10-16 14:51:56 +05:00

KK_AnisotropicMorph

A BepInEx plugin for Koikatsu that adds anisotropic physics simulation to breast and butt bones, providing more realistic and configurable jiggle behavior than the game's built-in Dynamic Bones.

Requirements

  • KK / Koikatu / Koikatsu Party
    OR
  • KKS / Koikatsu Sunshine
  • BepInEx 5.x
  • ABMX (KKABMX)

Installation

Drop KK_AnisotropicMorph.dll into BepInEx/plugins/.

Configuration

Settings are accessible via the BepInEx Configuration Manager (F1).

General

Setting Description
Enable Apply physics to Male, Female, or both
MaleEnableDB Force-enable Dynamic Bones on male characters (normally disabled by the game)
FilterFPS Smooth out framerate spikes to avoid physics glitches at low FPS

Breast / Butt

Both body parts share the same set of parameters.

Effects — choose which physics effects are active:

  • Linear — spring-based position offset
  • Angular — rotational tilt
  • Tethering — oscillation/bounce effect
  • Acceleration / Deceleration — velocity-based scale squash & stretch
  • GravityLinear — directional gravity offset
  • GravityAngular — directional gravity tilt
  • GravityScale — gravity-driven scale response

AdjustForSize — scale physics response proportionally to the character's body size.

DisableClothed — automatically disable physics when specific clothing slots are occupied (Top, Bot, Bra, Panty, Gloves, Pantyhose, Socks, ShoesIn, ShoesOut).


Linear parameters

Setting Description
LinearStrength Spring force pulling bone back to rest position
LinearDamping Resistance to movement (higher = less oscillation)
LinearGravity Constant downward force
LinearLimitPositive/Negative Max displacement per axis (X/Y/Z)

Angular parameters

Setting Description
AngularStrength Rotational spring force
AngularDamping Resistance to rotation
AngularMaxAngle Maximum rotation angle
AngularApplyToRoot Apply rotation to root bone (axes)
AngularApplyToBone Apply rotation to child bone (axes)

Scale parameters

Setting Description
ScaleAccelerationFactor Squash amount when bone accelerates
ScaleDecelerationFactor Stretch amount when bone decelerates
ScaleLerpSpeed How quickly scale returns to normal
ScaleMaxDistortion Maximum scale change
ScaleUnevenDistribution Per-axis scale weight (X/Y/Z)
ScalePreserveVolume Compensate scale on other axes to preserve volume
ScaleDumbAcceleration Simplified acceleration calculation

Tethering parameters (requires Tethering effect enabled)

Setting Description
TetheringMultiplier Oscillation strength (negative = inward pull)
TetheringFrequency Oscillation speed
TetheringDamping Oscillation decay rate
TetheringMaxAngle Maximum tether angle