Changing settings - JusMahBASSCannon/KKRagdollRevamp GitHub Wiki
KKRagdollRevamp allows customization options that allow you to tailor the plugin to your preferences. You can access these settings by pressing the F1 key and scrolling down until you see "KKRagdollRevamp", or by using the search bar at the top.
Here is the guide on what each setting does:
[!NOTE] This setting menu changes often - check back to this page whenever the menu changes!
Click and Drag
Rotate in Place Hold Shortcut - The key to be held down to start rotating the dragged body part.
Toggle Rotate in Place (UNFINISHED) - Enables a WIP feature allowing body parts to be rotated in place while dragging.
Mid-Air Rotation Speed - How sensitive the rotation is when moving the mouse and holding down the shortcut.
Push/Pull Strength - How much the ragdoll should move towards or away from camera in a single click of the scroll wheel.
Distance - How far away the ragdoll should follow the cursor during a Click and Drag. Higher values mean further distance away from the mouse, lower values mean closer.
Angular Drag - Dictates how fast body-parts can rotate in relation to the mouse cursor. Almost never used, will probably be patched out in a later version.
Linear Drag - Dictates how fast body parts move in air when being moved by the mouse cursor. Higher values mean slower movement, lower values mean snappier controls.
Damper - Dictates how fast the air slows down the ragdoll when moving the mouse at high speeds. Higher values mean slower movement, lower values mean snappier controls.
Spring - The strength of the mouse when clicking and dragging. Higher values mean snappier ragdoll movement, lower values mean smoothed, gradual movement.
Auto Lock Camera - Enables or disables auto-locking of the camera during a click and drag. This should always be enabled unless you're debugging something or getting fancy with moving the camera and ragdolls at the same time.
Toggle Click and Drag - Enables or disables the click and drag feature.
Debug
Auto Disable Colliders - When set to true, KKRagdollRevamp will automatically disable breast, skirt and floor colliders and re-enable them when the ragdoll is toggled off. This is to prevent glitches that happen with the ragdoll if these colliders are left on. You probably don't need to change this unless you're debugging!
Auto Disable KKABMX - When set to true, KKRagdollRevamp automatically disables KKABMX on the character before starting the ragdoll. This is to prevent the ragdoll gliding across the floor, which is caused by any bonemod edits. This has the current side effect of causing a proportion glitch when changing outfits (#2).
*Auto Disable Stiletto - When set to true, KKRagdollRevamp automatically disables Stiletto before starting the ragdoll. This is to prevent rotating ankles during ragdoll toggles.
Experimental
Auto Toggle IK - If the Kinematics mode is set to IK, KKRagdollRevamp will automatically turn off IK when starting the ragdoll. This creates some unexpected behavior, however, including the need to turn IK off and on to refresh it after turning off the ragdoll.
[!WARNING] Don't turn on IK or FK when a character is in ragdoll mode! This will cause the ragdoll to glitch out, and the only way to fix this is to re-toggle the ragdoll.
Explode
Upwards Force - How much the explosion will throw the ragdoll up into the air. Set this value low for almost no vertical movement, set this value high for vertical movement to take dominance.
Power - How strong the explosion is.
Radius - How wide the explosion circle is.
Keyboard Shortcut - Choose the button to press to trigger an explosion at the mouse position.
Explode Toggle - Enable or disable the explosion at mouse position feature.
Keyboard Shortcuts
Activate All Ragdolls - Toggles the ragdoll status for all characters in the scene. Activate Ragdoll - Toggles the ragdoll status for only selected characters in the Workspace.