Plugins + Scripts AutoThruster Plus

Updates to the plugin (none break existing scenes or settings):
1 - Added a toggle for use during "Stationary Penis" to disallow the plugin from adjusting any of the Penis node settings during thrust
- Only works during "Stationary Penis" settings
- requested by @gghhoosstt123
2 - Added Transitional (and End) Triggers to the Cycle Trigger. This allows you to power any other slider or variable triggered setting (like morphs), synced to the thrust cycle.
- Requested by @babul
3 - Added Manual Thrust Modes for VR and Desktop. Control the thrust with your VR controller or a keyboard key. Squeeze the trigger, figure thrusts in, let it go, figure pulls back out, etc.
- I've long tried to figure out how to implement a user generated thrust so that YOU can control it. That is now here!
- VR controller gives better response since the controller button has variable rate, Keyboard mode doesn't allow for that, so it's simply in or out.
- This mode is created as a "State" so it doesn't get saved with the presets, allow you to turn that state on or off within your scene as desired, not needing a separate preeset.
- These modes can only be turned on or off when Thrust is NOT enabled. This is to prevent any glitches in thrust that might explode your figures.
- These modes are currently considered "BETA" and may change upon need or suggestion yet.

Implemented several code optimizations to allow for faster loading of the plugin, reduce FPS drag when menu is open and reduce overhead for body motions that aren't being used.

ALSO, a note about Dildo use and Hand Jobs. Due to those actions being similar but different, those are going to have to be a separate plugin.
This plugin is already getting pretty complicated and weighty and I think a separate Dildo Thruster plugin (already started) and a related Hand Job plugin are the better ways to go for those.

This is a pretty large update. Presets should all still work (with the exception of one piece.

New Features

• Pull-Out Angle — During a "pull-out", the penis can now tilt upward (allowing for higher cumshots, etc)
• Angle Return Point - Change when the angle from the pullout resets during the Re-Insert (has negative values to allow angle return even before insert)
• Penis Stiffness — New slider that controls how stiff/floppy the penis mid and tip nodes are during thrusting (adjusts their joint spring strength).
  • Resets nodes to what they were set at on thrust disable.
• Node Power — New slider that controls how forcefully the plugin holds the penis base controller in position during thrusting. Higher = more rigid, more responsive.
  • This helps get a harder snappier thrust if set higher, or a more fluid thrust if set lower
• Thrust Angle Allowance — New setting that lets the plugin follow the penis's natural pointing direction rather than forcing it straight toward the target. Useful when the anatomy is at an angle to the target.
• On-Cycle Trigger — A new trigger that fires once per thrust cycle at a point you choose. Lets other plugins or timeline react to each individual thrust.
• Delayed Pull-Out / Re-Insert Triggers — The existing "On Pulled Out" and "On Re-Inserted" VaM triggers now have delay sliders, so you can fire them a moment after the event actually happens.
• Cycle Apex Visualization — A new toggle shows colored debug spheres: blue at the retracted (out) point, yellow at the deep (in) point, and white at the current penis base position. Different from the existing green/red target point spheres.
• Hover Tooltips — All sliders and toggles now show a tooltip when you hover over them explaining what they do. (Thank you to @Skynet )
• Reset All — A new action that resets every setting to defaults at once.

---

Changed Behavior

• Phase Lag split into two — The single "Phase Lag" slider has been split into "Person Phase Lag" (controls the wave timing through the thruster's own hips → chest → head) and "Target Phase Lag" (same but for the receiving person). A "Target Cycle Delay" slider was also added to shift the target's whole response later in the cycle. Old presets will automatically migrate — the old single value gets applied to both new sliders.
• Target body motion now has independent timing — The target person's hip, chest, and head body reactions are now driven by their own phase-lagged signal, instead of sharing the same one as the thruster. This means you can make the receiver's body react slightly differently in timing than the thruster's.
• More motion axes for all body parts — Hip, chest, and head forces and torques now have all three axes available (left-right, up-down, forward-back for force; pitch, yaw, roll for torque). Previously, left-right force and several torque axes were missing.
• Variability now randomizes thrust depth — The variability slider now affects how deep each thrust goes (randomly shallowing the peak of each cycle) rather than randomly scaling the body motion forces. The motion itself stays controlled; only the depth varies.
• Unsynced variability now correctly separated — In Unsynced Extra mode, person variability now only affects the person's body parts, and target variability only affects the target's — they were previously linked together.

Added a new tab to add extra body motions that do NOT sync with the thrust. Example - While the main thrust is happening, one or both are moving their heads down up. etc. Pretty much any movement that isn't in sync with the thrust motions.

Clarifications for Sync Mode
Thruster Sync - All Unsynced motions on the Thruster will happen together. Any on the Target will happen randomly.
Target Sync - All Unsynced motions on the Target will happen together. Any on the Thruster will happen randomly.
Both Separate - All Unsynced motions on the Thruster will happen together. All Unsyced motions on the Target will happen together. Target and Thruster will happen separately.
Both Together - All Unsynced Motions of both figures will happen together.

BIG Update!
1 - Added Breast target option for Titty fucks
2 - Added tabs/pages for better organization of the plugin
3 - Added some of the missing Thruster Extra Movements to match what the Target atom has.
4 - Finally fixed the Pullout functionality
5 - Added another trigger system for "Re-Insert" (see Pullout section)
6 - Organized the Extra Body Movements page (left side all Thruster, right side all Target).
7 - Complete Instruction page for guidance and overall usage.

Still backwards compatible and old presets still work.

While packing up an upcoming scene, I noticed this plugin wasn't able to load presets from or even see var files. This fixes that.

Small tweak to make setting up triggers to load presets easier now with a file picker (vs having to manually type in a file path).
Thank you to @sdfg3456 for finding the correct code method.
Old method still intact so this update shouldn't break anything.

This update adds another way to control the thrust speed.

Duration Range Bias - This is still the default and allows for the plugin to randomly choose a cycle duration (within the Min and Max parameters) with a "bias" towards one end or the other. Meaning that if you have the Bias set to zero, it has a bell curve centered on the shortest duration, but can still choose durations in the range based on that bellcurve. And if it's set all the way up, it centers the bell curve on the slowest duration, yet can still choose durations in the whole range also based on that bellcurve. Basically, it's a "bias" towards certain speeds, but still allows for variation. This method is my personal favorite because it allows for more realistic variation in thrusting.

Constant Speed - Toggling this on, will bypass the Bias and uses the set amount to literally go from the fastest duration set to the slowest duration set. @5DVoom requested this feature and I can see it's value. The power is in your hands.

IMPORTANT NOTE - This plugin works on thrust "cycles". A cycle is a complete IN and OUT of the thrust. Speed will not change until the end of one cycle and the beginning of another. It ALSO has sliders to set a minimum and maximum for cycles before any speed change happens. So if you want the most responsive thrust changes, make sure to set these both at 1. This feature is there so that you can have a random amount (between the min and max) of cycles before any change happens.

This update does not break scenes or old presets.

1 - Added a reset button to reset all settings to default
2 - Added a bit more smoothing to when presets are loaded during active thrust (will still likely work on this more)
3 - Tweaked Duration Change Rate to dissallow setting this to zero
4 - Added and OUT Phase motion percentage for the Thruster (this already existed for the Target person)
5 - increased the Out Phase Motion percentage up to 2 to allow for up to twice as much motion on the OUT phase as the In phase (I found I needed this for certain blow job motions etc.)

I realized that there was some motion jitter caused by some of the math in the plugin, especially at slower thrust speeds. These have now been smoothed out. This did require some changes with the Extra Body Motions which MIGHT have a slight impact on your scenes. But otherwise, Jitters are gone and motion is much smoother.