Skip to content

Latest commit

 

History

4 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PerceptiveHeightX

A CharaStudio add-on for KK_PerspectiveX that plays with size perception: your POV character remembers the height they used to be, and a HUD shows how tall the other character feels to them as sizes change. Works on Koikatsu / Koikatsu Party and Koikatsu Sunshine.

The HUD while in POV

Here's the trick. The moment a character enters POV, their current height gets saved as their "reference height". That's the height they still feel like they are in their head, and it stays put no matter what happens to their body afterwards. When their actual height changes, the mismatch gets applied to whoever they're looking at:

perceived = other_actual * (reference / pov_actual)

Say your POV character is 180 cm when POV starts, looking at a 140 cm character. Shrink yours down to 160 cm. They still feel 180 in their head, so the other character now reads as 140 * (180/160) = 157.5 cm to them. Nothing about the other character changed, their world just got bigger.

The HUD keeps both numbers live:

POV: 180.0 cm
Marcy to POV: 157.5 cm

Top line is the anchor, the height your character still feels like. Bottom line is what the other character reads as, recalculated every frame while you drag sliders and scale things.

Using it

  • Enter POV with PerspectiveX like you normally would. The first time a character enters POV their height locks in as the reference, and it sticks for the whole session. Toggling POV off and on won't reset it.
  • Press Home whenever you want a new anchor, it relocks the reference at the current height (rebindable). If you'd rather have it relock on every POV enter, there's a config option for that.
  • The "other" character is whoever you have selected in the Workspace that isn't the POV character. Nothing else selected? The last pick stays, and a scene with just one other character picks them by itself.
  • Drag the HUD with left mouse to put it wherever, it remembers the spot.
  • F1 (ConfigurationManager) for the rest: on/off, hotkey, cm or feet/inches, font size, HUD position.
  • The HUD gets out of the way during Screencap screenshots.

Install

You need BepInEx 5.x, KKAPI (KKSAPI for Sunshine) and KK_PerspectiveX. If you run a repack you already have the first two.

Grab the right zip from Releases and drop the DLL into BepInEx/plugins:

  • PerceptiveHeightX.KK_*.zip for Koikatsu / Party
  • PerceptiveHeightX.KKS_*.zip for Sunshine

It's a true optional add-on: PerspectiveX doesn't care whether this is installed, and without PerspectiveX this plugin just sleeps.

Where the numbers come from

Heights are measured exactly the way StudioHeightX does it: distance from the character's root to the game's own head-top attach point (a_n_headtop), using the cm calibration from ManlyMarco's HeightBar, times the actual world scale. So the numbers match what StudioHeightX shows, and Studio scaling counts as a real size change, which is the whole point here.

Stuff to know

  • Same warning as StudioHeightX: ABMX edits that scale or move the feet/legs throw the root origin off, so those characters will measure wrong
  • Height is measured in the current pose. A crouching character genuinely reads shorter, and the mechanic treats that as real
  • Several other characters in the scene and none selected? The second line hides instead of guessing

Building

No game files needed, everything restores from NuGet:

./package.sh

builds both game targets and drops the release zips in dist/. Or build one target directly with dotnet build src/PerceptiveHeightX.KK/PerceptiveHeightX.KK.csproj -c Release.

The XMods

My links

License

MIT

About

Companion plugin for KK_PerspectiveX: your POV character remembers the height they used to be, and a HUD shows how tall the other character feels to them. For Koikatsu and Koikatsu Sunshine CharaStudio.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages