Jiggle Physics for Sexy Lads

[Summary]
* Uses the in-game physics engine to:
* * Add jiggle physics to pecs, butt, bulge, balls and dick for male Hyur, Elezen, Miqo'te, Roegadyn, Au Ra, Hrothgar and Viera.
* * Add collision detection with torso and legs to prevent dicks from clipping into the body.
* Includes 60 and 144 FPS options to counteract a defect in the in-game physics engine where physics become stiffer with increasing frame rate.
* Includes flaccid and erect dick physics options.

[Description]
* Have you ever wanted your lads to have sexy jiggle physics during your adventures or while Gposing? Now you can!
* Check out the video demo here in my X post: https://x.com/LeoTheRoegadyn/status/1833869656626729346
* This mod pack contains Cap'n Leo's in-game physics engine parameters, configured to create jiggle physics for selected body parts. The parameters are tuned to make the jiggle physics look as realistic as possible within the limits of the physics engine.
* * Pecs and butt jiggle physics: Use emotes such as /box and /cheerjump to see how the pecs and butt jiggle like firm muscles do.
* * Bulge jiggle physics: Use emotes such as /box and /cheerjump to see how the bulge jiggles and returns to position quickly being held in place by the pants.
* * Balls dangle physics: Use emotes such as /pushups and /waterfloat to see how the balls dangle downwards towards the ground.
* * Flaccid dick dangle physics: Works on flaccid and erect legs/dick models. Use emotes such as /situps and /mandervillemambo to see how the dick dangles and has collision detection with torso and legs.
* * Erect dick jiggle physics: Only works on erect legs/dick models. Use emotes such as /box and /cheerjump and observe how the dick jiggles like a stiff meat stick and has collision detection with torso and legs.
* The in-game physics engine has a defect which causes physics to become stiffer with increasing frame rate. 2 sets of physics parameters are created for 60 FPS and 144 FPS gameplay to compensate for the defect.

[Mod Dependencies]
* Ensure that the following mods are also installed and activated:
* * Illusio Vitae Custom Skeletons V2_2: https://www.xivmodarchive.com/modid/32159
* * The Body SE-X IVCS2 V1_1_0: https://www.xivmodarchive.com/modid/42647
* * The hrBody 3 IVCS2 4K V1_0_0: https://www.xivmodarchive.com/modid/32159
* This mod pack is tailored for TBSE-X and HR3 body mods that use IVCS2 skeleton. It should also work with other body mods that use IVCS2 skeleton but there may be clipping or other issues.

[Usage]
1. Download the Penumbra Mod Pack File (.pap).
2. In the game, open Penumbra, import the mod pack and activate it. Set the priority to a number larger than the mod dependencies.
3. Select your preferred jiggle physics option.
3.1. For frame rate:
3.1.1. For users who cap their frame rate at 60 FPS, select "60 FPS".
3.1.2. For users who uncap their frame rate to run above 60 FPS, select "144 FPS".
3.2. For jiggle physics:
3.2.1. Select "Base and No Dick Physics" to add pecs, butt, bulge and balls physics. This is useful when playing animations that require precise positioning of dicks.
3.2.2. Select "Base and Flaccid Dick Physics" to add pecs, butt, bulge, balls and dick physics. Both flaccid and erect legs/dick models have flaccid dangle physics.
3.2.3. Select "Base and Erect Dick Physics" to add pecs, butt, bulge, balls and dick physics. Erect legs/dick models have erect jiggle physics. Flaccid legs/dick models have flaccid dangle physics.
4. Check the in-game settings at "System Configuration" > "Graphics Settings" > "Movement Physics" and ensure that the "Full" option is selected for the required targets.
5. Enjoy the jiggle physics added to all animations.

[Important Notes]
* The in-game "Movement Physics" "Full" setting is required to enable the in-game physics engine. If this overstrains your system, consider applying it only for "Self".
* Dick collision detection with torso and legs are tailored for TBSE-X and HR3 body mods. Clipping may be experienced with other body mods or custom size scaling.
* For high frame rate users, plugins that limit physics frame rate to 60 are not recommended due to choppy animations. Instead, select the "144 FPS" frame rate option in this mod pack. There are currently no options for higher frame rates, and playing at frame rates above 144 FPS while using the "144 FPS" option may result in stiffer physics behavior.
* Bulge physics only works with legs/pants models that are made to react to movements in the IVCS2 iv_kuritto bone.
* Due to how the game structures body physics parameters as a single data file, it is not possible to mix and match physics for different body parts from different mods. Setting the priority of this mod pack to a number larger than the mod dependencies will completely override all body physics from the dependencies.

[Permissions]
* Please do not redistribute the mod pack without my permission, such as uploading it to other websites or Discord servers.
* You may edit the mod pack for your personal use, but please do not publish or sell it under your name without my permission.

[Help and Suggestions]
* Contact me at my Discord server (NSFW warning): https://linktr.ee/leotheroegadyn